Search Overlay
Searchbox effacer les filtres de recherche ESC
Filter PreferencesClear

No results found

Création des fichiers Account Updater

Les fichiers Account Updater sont au format CSV que vous téléversez sur le site SFTP de Paysafe. Votre fichier CSV peut contenir des dossiers pour un ou plusieurs comptes marchand, à condition que vous soyez le titulaire légitime de ces comptes.

Cette rubrique décrit les éléments suivants :

Formatage de votre fichier

Votre fichier CSV doit être conforme à ce qui suit :

  • Ne pas avoir d’espace entre les valeurs.
  • Chaque ligne (enregistrement) du fichier doit contenir les données d’une seule requête d’actualisation des comptes.
  • Les valeurs de chaque enregistrement doivent être celles spécifiées dans Champs de fichier Account Updater et dans l’ordre de leur énumération.
  • La taille maximale d’un fichier Account Updater est de 1 Mo.
  • Pour des performances optimales, chaque fichier Account Updater ne doit pas dépasser 3 Mo ou 50 000 enregistrements.

Si un enregistrement du fichier téléversé comporte une erreur, par exemple un champ manquant, aucune partie du fichier ne sera traitée et vous recevrez un accusé de réception de Paysafe, indiquant les enregistrements erronés afin que vous puissiez les corriger et téléverser à nouveau le fichier.

Nomenclature de votre fichier

Vous devez utiliser la convention suivante pour nommer votre fichier Account Updater :

upd_<YourUniqueFilename>.csv

Par exemple :

upd_00001.csv

Le nom de votre fichier doit être composé uniquement de caractères alphanumériques et de traits de soulignement. N’utilisez pas de caractères spéciaux, tels que des tirets, des espaces ou des guillemets, pour nommer votre fichier. Si vous ne nommez pas votre fichier de cette manière, il ne sera pas traité.

Une fois le fichier chiffré (voir Chiffrement de vos fichiers Account Updater), le nom du fichier obtient une extension .gpg ; par exemple :

upd_00001.csv.gpg

Champs de fichier Account Updater

Le tableau suivant décrit les champs qui doivent être inclus dans chaque enregistrement du fichier Account Updater. Hormis l’identifiant du magasin et le mot de passe du magasin, qui sont facultatifs, vous devez remplir tous les champs pour toutes les méthodes d’identification des enregistrements, à l’exception de la date d’expiration et du type de carte, qui ne sont nécessaires que lorsque vous utilisez le numéro de la carte de crédit. Si vous omettez l’identifiant ou le mot de passe du magasin, vous devez quand même inclure le champ vide, avec les virgules nécessaires, dans vos enregistrements.

Champs de fichier Account Updater
ChampDescription
FMAVotre numéro de compte marchand Paysafe. Jusqu’à 10 chiffres.
Identifiant de magasinVotre identifiant de magasin Paysafe; fourni par Paysafe lors de l’intégration; il est utilisé pour authentifier votre requête. Jusqu’à 80 caractères. Facultatif, mais si vous laissez le champ vide, vous devez quand même inclure les virgules nécessaires.
Mot de passe de magasinLe mot de passe de votre magasin Paysafe; fourni par Paysafe lors de l’intégration, il est utilisé pour authentifier votre requête. Jusqu’à 20 caractères. Facultatif, mais si vous laissez le champ vide, vous devez quand même inclure les virgules nécessaires.
Valeur d’enregistrement

Un identifiant d’enregistrement, qui est l’un des suivants :

  • Le numéro et la date d’expiration de la carte de crédit concernée. Vous pouvez l’utiliser avec l’API Services Web ou l’API Paiements hébergés de Paysafe.
  • NETBANX Ref. ID qui est renvoyé en réponse à une commande réussie par l’intermédiaire de l’API Paiements hébergés Paysafe. Obtenez la valeur de l’un ou l’autre :
    • L’identifiant renvoyé dans la réponse de l’API Paiements hébergés.
    • NETBANX Ref. ID sur la page des détails de la transaction lorsque vous exécutez un rapport d’activité dans le Portail Paysafe.

    • Le numéro de confirmation. Les marchands qui utilisent l’API Services Web de NETBANX pour traiter les données stockées de NETBANX (numéro de carte et date d’expiration) afin de traiter les facturations subséquentes peuvent inclure le numéro de confirmation qu’ils ont reçu de NETBANX en réponse à tout achat ou autorisation par carte réussi au cours des 24 derniers mois.

      • Si un nouveau numéro de carte et de nouvelles dates d’expiration sont renvoyés, NETBANX met à jour ses données stockées et les utilise pour les transactions ultérieures utilisant ce numéro de confirmation.

      • Si le compte de la carte est fermé, NETBANX met à jour ses données stockées en conséquence.
        Ne tentez pas d’effectuer une transaction en utilisant ce numéro de confirmation, car elle échouera.

      Le numéro de confirmation est

      • renvoyé à votre API lors du traitement des transactions par les services Web de NETBANX
      • sur la page des détails de la transaction lorsque vous exécutez un rapport d’activité dans le Portail Paysafe NETBANX; par exemple :
  • Le jeton de paiement. Il s’agit du jeton de paiement permanent reçu lorsqu’une carte est ajoutée à un profil dans le coffre-fort client.
Date d’expiration

Nécessaire uniquement lorsque vous utilisez un numéro de carte de crédit.

La date d’expiration de la carte de crédit au format MMAA.

Type de carte

Nécessaire uniquement lorsque vous utilisez un numéro de carte de crédit.

La marque de la carte de crédit, qui est soit :

  • VI
  • MC
Types d’enregistrement

Le type d’enregistrement que vous interrogez. Soit :

  • CARD – L’enregistrement contient un numéro de carte de crédit et une date d’expiration
  • NBX – L’enregistrement contient un NETBANX Ref. ID pour un ordre de paiement hébergé précédemment traité.
  • CONF – Vous envoyez un numéro de confirmation pour une transaction Web Services déjà traitée dans l’enregistrement.
  • PAYMENT_TOKEN - L’enregistrement contient un jeton de paiement permanent

Exemples d’enregistrements

Voici des exemples d’enregistrements valides.

Carte de crédit

Cet enregistrement contient un numéro de carte de crédit et une date d’expiration :

99980369,my_store_ID,my_store_pwd,4445999999999997,1221,VI,CARD

Carte de crédit sans identifiants de marchand

Voici un exemple d’enregistrement valide qui ne contient ni l’identifiant ni le mot de passe du magasin :

99980369,,,4445999999999997,1212,VI,CARD

Si vous omettez la valeur d’un champ facultatif, vous devez tout de même inclure une place pour ce champ, séparée par des virgules (par exemple, valeur,valeur, , ,valeur).

NETBANX Ref. ID

Cet enregistrement contient un NETBANX Ref. ID :

99980369,my_store_ID,my_store_pwd,261NQJ7QSZ0VEOL1LP,,,NBX

Numéro de confirmation

Cet enregistrement contient un numéro de confirmation :

99980369,my_store_ID,my_store_pwd,219413540,,,CONF

Jeton de paiement

Cet enregistrement contient un jeton de paiement :

1003259910,,,CUBjstItPKXumHg,,,PAYMENT_TOKEN

Sur cette page