Downloading Files

Once your file has been processed by Paysafe, you can download these types of file using SFTP:

  • A detailed acknowledgement file. This file is not encrypted.
  • An encrypted, detailed response file. Normally, there will be multiple response files available for each file you uploaded successfully (those files with the status of Completed). For details, see Response file contents.

This topic describes the following:

Downloading acknowledgement files

If you uploaded your Account Updater file before the 5:30 a.m. EST deadline, the acknowledgement files are typically ready for download 30 minutes later (in other words, after 6.00 a.m.).

When you use WinSCP to communicate with Paysafe, you will see a folder labeled Outgoing, which contains the acknowledgement and response files.

Acknowledgement files have the following naming convention:

upd_<original_merchant_filename>_YYYYMMDD_HHMMSS_S.ack

For example:

upd_merchantGenericTestPub.csv_20121228_121143_123.ack

The order of the records in the acknowledgement file matches the order of the records in the Account Updater file you originally submitted. Each row in the acknowledgement file contains the following values for each record submitted.

Acknowledgement file contents
Field Description
Record Position The position of the record in the original file you submitted (For example: 1 for record 1, 5 for record 5).
Status

The result of record processing; either:

  • RECORD ACCEPTED
  • RECORD REJECTED
Return Code If the decision for the record was RECORD REJECTED, the return code and its description.

Acknowledgement file examples

The following is an example of a valid acknowledgement file downloaded from Paysafe. This was in response to a file you uploaded that contained 3 records, all of which were processed since all were valid.

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

The following is an example of a valid acknowledgement file downloaded from Paysafe. The uploaded file was not processed, because it contained an invalid record.

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

If the file is rejected for some reason other than it contains an invalid record (for example, the file was empty, exceeded the maximum file size, or was a duplicate), the acknowledgement file will contain only one entry, with no record position field provided, and a response code indicating why the uploaded file was rejected. For example:

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

Downloading response files

Once Paysafe has processed your file (normally within 24 hours, but can take up to 4 days in rare circumstances), you can use WinSCP to access the SFTP site to retrieve the corresponding response files. Paysafe returns all responses as they are received from the card associations, and the Outgoing folder may contain any number of files, depending on the responsiveness of the card associations.

Paysafe posts response files each day at noon, and purges the the Outgoing folder daily at 2 a.m.

If you fail to retrieve your response files before they are deleted, contact Technical Support within two days to have them re-posted to the Outgoing folder..

Once you have retrieved a response file from the Paysafe SFTP site, you should delete it from the Outgoing folder.

Response files are GNUPG-OpenPGP encrypted with the merchant’s public key, and have the following naming convention:

upd_response_<YYYYMMDD_HHMMSS_S>.gpg

For example:

upd_response_20211228_122007_123.gpg

When you have decrypted a response file, you will see that it contains the following fields from the records in the Account Updater file you uploaded.

  • Original Card Number/Confirmation Number
  • Original Expiry Date

You can use these fields to match response file records with ones in the Account Updater file.

If you do not receive a response for a record containing a Mastercard update, it means that the update was not required and, therefore, that Mastercard did not return any new information.

Paysafe returns all responses as they are received from the card associations. The Outgoing folder may contain any number of files, depending on the responsiveness of the card associations.

Decrypting response files

To decrypt your response files:

  1. Generate an RSA key pair. Paysafe recommends the following:
    • Use GNUPG – an OpenPGP implementation.
    • Ensure that the RSA public key is set as per the recommended standard (at least 2048-bits)
    • Ensure that the symmetric algorithm used to encrypt the data using the PGP session key is set to AES 128/256, depending on the PGP tool support.
    • If AES is not supported, use Triple DES with Keying option 1 (all three keys chosen independently).
    • Block cipher in CBC/CFB/CTR/CCM-AES only mode.
    • When configuring PGP, ensure the integrity check of the cipher is set to use SHA1/2.
  1. In the merchant back office, click the Settings tab.
  2. Click Manage Keys.
  3. Paste your public key into the PGP data field, and then click Save.

  4. Paysafe encrypts the Account Updater response file using your public key.
  5. Once you download the response file, you can decrypt it with the corresponding private key.

Response file contents

Each row in the response file contains the following values for each record you originally submitted, provided a match was found for that record.

Field Description
Record Position The position of the record in the original file you submitted (for example, 1 for record 1, or 5 for record 5).
Record Type

The type of record you inquired about; either:

  • CARD – A credit card number and expiry date were provided
  • CONF – A confirmation number returned for a previously processed transaction was provided.

  • NBX – A NETBANX reference ID for a previously processedHosted Payments order was provided
Card Brand

The brand of the credit card; either:

  • VI
  • MC
Decision Whether the service could find a credit card/expirydate, confirmation number or NETBANX reference ID to match the record submitted. See Response file decision codes and descriptions for details.
Original Card Number / Reference ID The credit card number or NETBANX reference ID in the record you submitted.
Original Expiry Date

Returned only for Card number records.

The expiry date of the credit card inthe record you uploaded.

New Card Value
  • For card number – a new credit card number
  • For confirmation or NETBANX reference ID – the last 4 digits of the credit card number, if any card update is provided.

New Expiry Date
  • For card number – a new expiry date
  • For confirmation number or NETBANX reference ID – the new expiry date, if provided by the card issuer, or the original expiry date, if a new card number only is provided by the card issuer.

Example response file

The following is an example of a response file downloaded from Paysafe.

Fields contain values only if Paysafe obtains these values. For example, if the card details match the issuer's records and there is no change, the Decision field will indicate that this is the case, and the New Card Value field and the New Expiry Date field will be empty. If the record does not match any in the issuer's database, it will not appear in the response file.

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

In this example, records 1, 3, 5 and 9 have a new expiry date provided, record 7 has no new values returned.

Did you find this page useful?