Search Overlay
Searchbox effacer les filtres de recherche ESC
Filter PreferencesClear

No results found

Téléchargement des fichiers

Une fois que votre fichier a été traité par Paysafe, vous pouvez télécharger ces types de fichiers à l’aide de SFTP :

Cette rubrique décrit ce qui suit :

  • Téléchargement des fichiers d’accusé de réception
  • Téléchargement des fichiers de réponse
  • Déchiffrement des fichiers de réponse
  • Contenu d’un fichier de réponse

Téléchargement des fichiers d’accusé de réception

Si vous avez téléversé votre fichier Account Updater avant l’heure limite de 5 h 30 heure de l’EST, les fichiers d’accusé de réception sont généralement prêts à être téléchargés 30 minutes plus tard (autrement dit, après 6 heures du matin).

Lorsque vous utilisez WinSCP pour communiquer avec Paysafe, vous verrez un dossier intitulé Sortant, qui contient les fichiers d’accusé de réception et de réponse.

Les fichiers d’accusé de réception ont la convention d’appellation suivante :

upd_<original_merchant_filename>_YYYYMMDD_HHMMSS_S.ack

Par exemple :

upd_merchantGenericTestPub.csv_20121228_121143_123.ack

L’ordre des enregistrements dans le fichier d’accusé de réception correspond à l’ordre des enregistrements dans le fichier d’actualisation des comptes que vous avez soumis à l’origine. Chaque ligne du fichier d’accusé de réception contient les valeurs suivantes pour chaque enregistrement soumis.

 Contenu du fichier d’accusé de réception

 
ChampDescription
Position de l’enregistrementLa position de l’enregistrement dans le fichier original que vous avez soumis (par exemple : 1 pour l’enregistrement 1, 5 pour l’enregistrement 5).
État

Le résultat du traitement de l’enregistrement; soit :

  • RECORD ACCEPTED
  • RECORD REJECTED
Code de renvoiSi la décision pour enregistrement était RECORD REJECTED, le code de renvoi et sa description.

Exemples de fichiers d’accusé de réception

Voici un exemple de fichier d’accusé de réception valide téléchargé depuis Paysafe. Il s’agit d’un fichier que vous avez téléchargé et qui contenait trois enregistrements, qui ont tous été traités car ils étaient tous valides.

1,RECORD ACCEPTED
2,RECORD ACCEPTED
3,RECORD ACCEPTED

Voici un exemple de fichier d’accusé de réception valide téléchargé depuis Paysafe. Le fichier téléversé n’a pas été traité car il contenait un enregistrement non valide.

1,RECORD REJECTED,9057
2,RECORD ACCEPTED
3,RECORD ACCEPTED

Si le fichier est rejeté pour une raison autre que le fait qu’il contienne un enregistrement invalide (par exemple, le fichier était vide, dépassait la taille maximale du fichier ou était un doublon), le fichier d’accusé de réception ne contiendra qu’une seule entrée, sans champ de position d’enregistrement, et un code de réponse indiquant la raison pour laquelle le fichier téléversé a été rejeté. Par exemple :

FILE REJECTED,Mon Jan 14 15:29:25 EST 2018,9052

Téléchargement des fichiers de réponse

Une fois que Paysafe a traité votre fichier (normalement dans les 24 heures, mais cela peut prendre jusqu’à 4 jours dans de rares circonstances), vous pouvez utiliser WinSCP pour accéder au site SFTP afin de récupérer les fichiers de réponse correspondants. Paysafe renvoie toutes les réponses au fur et à mesure qu’elles sont reçues des associations de cartes, et le dossier Sortant peut contenir un nombre quelconque de fichiers, en fonction de la réactivité des associations de cartes.

Paysafe publie les fichiers de réponses chaque jour à midi et purge le dossier Sortant tous les jours à 14 heures.

Si vous ne parvenez pas à récupérer vos fichiers de réponse avant qu’ils ne soient supprimés, contactez le soutien technique dans les deux jours pour qu’ils soient réaffichés dans le dossier Sortant.

Une fois que vous avez récupéré un fichier de réponse sur le site SFTP de Paysafe, vous devez le supprimer du dossier Sortant.

Les fichiers de réponse sont chiffrés par GNUPG-OpenPGP à l’aide de la clé publique du marchand et portent le nom suivant :

upd_response_<YYYYMMDD_HHMMSS_S>.gpg

Par exemple :

upd_response_20211228_122007_123.gpg

Lorsque vous avez déchiffré un fichier de réponse, vous verrez qu’il contient les champs suivants des enregistrements du fichier Account Updater que vous avez téléversé.

  • Numéro de la carte originale/numéro de confirmation
  • Date d’expiration originale

Vous pouvez utiliser ces champs pour faire correspondre les enregistrements du fichier de réponses avec ceux du fichier Account Updater.

Si vous ne recevez pas de réponse pour un enregistrement contenant une mise à jour Mastercard, cela signifie que la mise à jour n’était pas nécessaire et, par conséquent, que Mastercard n’a pas renvoyé de nouvelles informations.

Paysafe renvoie toutes les réponses au fur et à mesure qu’elles sont reçues des associations de cartes. Le dossier Sortant peut contenir un nombre quelconque de fichiers, en fonction de la réactivité des associations de cartes.

Déchiffrement des fichiers de réponse

Pour déchiffrer vos fichiers de réponse :

  1. Générez une paire de clés RSA. Paysafe recommande ce qui suit :
    • Utilisez GNUPG – une implémentation OpenPGP.
    • Veillez à ce que la clé publique RSA soit définie conformément à la norme recommandée (au moins 2 048 bits).
    • Assurez-vous que l’algorithme symétrique utilisé pour chiffrer les données à l’aide de la clé de session PGP est défini sur AES 128/256, en fonction de la prise en charge de l’outil PGP.
    • Si AES n’est pas pris en charge, utilisez Triple DES avec l’option de codage 1 (les trois clés sont choisies indépendamment).
    • Chiffrement par blocs en mode CBC/CFB/CTR/CCM-AES uniquement.
    • Lors de la configuration de PGP, assurez-vous que la vérification de l’intégrité du chiffrement est réglée sur SHA1/2.
  2. Dans le Portail Paysafe, cliquez sur l’onglet Paramètres.
  3. Cliquez sur Gérer les clés.
  4. Collez votre clé publique dans le champ de données PGP, puis cliquez surEnregistrer.
  5. Paysafe chiffre le fichier de réponse Account Updater à l’aide de votre clé publique.
  6. Une fois le fichier de réponse téléchargé, vous pouvez le déchiffrer à l’aide de la clé privée correspondante.

Contenu d’un fichier de réponse

Chaque ligne du fichier de réponse contient les valeurs suivantes pour chaque enregistrement que vous avez initialement soumis, à condition qu’une correspondance ait été trouvée pour cet enregistrement.

ChampDescription
Position de l’enregistrementLa position de l’enregistrement dans le fichier original que vous avez soumis (par exemple : 1 pour l’enregistrement 1, 5 pour l’enregistrement 5).
Types d’enregistrement

Le type d’enregistrement demandé; soit :

  • CARD – Un numéro de carte de crédit et une date d’expiration ont été fournis.

  • CONF – Un numéro de confirmation renvoyé pour une transaction précédemment traitée a été fourni.

  • NBX – Un identifiant de référence NETBANX a été fourni pour un ordre de Paiements hébergés précédemment traité.

  • PAYMENT_TOKEN – Un jeton de paiement permanent a été fourni.

Marque de carte

La marque de la carte de crédit; soit :

  • VI
  • MC
DécisionSi le service a pu trouver une carte de crédit/date d’expiration, un numéro de confirmation ou un identifiant de référence NETBANX correspondant à l’enregistrement soumis. Voir Codes de décision et descriptions du fichier de réponsepour de plus amples renseignements
Valeur d’enregistrementValeur de l’enregistrement original du fichier que vous avez soumis.
Date d’expiration originale

Renvoyé uniquement pour les enregistrements de numéros de cartes.

La date d’expiration de la carte de crédit dans l’enregistrement que vous avez téléchargé.

Valeur d’une nouvelle carte
  • Pour le numéro de carte – un nouveau numéro de carte de crédit

  • Pour les autres types d’enregistrement – les 4 derniers chiffres du numéro de la carte de crédit, si une mise à jour de la carte est fournie.

Nouvelle date d’expiration
  • Pour le numéro de carte – une nouvelle date d’expiration

  • Pour les autres types d’enregistrement – la nouvelle date d’expiration, si elle est fournie par l’émetteur de la carte, ou la date d’expiration initiale, si seul un nouveau numéro de carte est fourni par l’émetteur de la carte.

Exemple de fichier de réponse

Voici un exemple de fichier de réponse téléchargé depuis Paysafe.

Les champs ne contiennent des valeurs que si Paysafe obtient ces valeurs. Par exemple, si les détails de la carte correspondent aux enregistrements de l’émetteur et qu’il n’y a pas de changement, le champ Décision indiquera que c’est le cas, et les champs Nouvelle valeur de la carte et Nouvelle date d’expiration seront vides. Si l’enregistrement ne correspond à aucun enregistrement de la base de données de l’émetteur, il n’apparaîtra pas dans le fichier de réponse.

1,CARD,VI,A,4445222299990007,1218,4445222299990007,1806,
3,CARD,MC,UPDATE,5444009999222205,1218,5444009999222205,1706
5,NBX,VI,A,881WWXUQSZ0PPOL2VC,,1234,0918
7,CARD,VI,V,5444009999222205,1218,,
9,NBX,VI,A,261NQJ7QSZ0VEOL1LP,,4321,0917,
11,PAYMENT_TOKEN,MC,UPDATE,CUBjstItPKXumHg,,1005,1225

Dans cet exemple, les enregistrements 1, 3, 5 et 9 comportent une nouvelle date d’expiration, l’enregistrement 7 ne comporte aucune nouvelle valeur, l’enregistrement 11 comporte un nouveau numéro de carte et une nouvelle date d’expiration.

Sur cette page