Access Worldpay
/
Testing
/
FTP

FTP testing

Once your Implementation Manager gives you a username and password, you can begin testing the file transfer process.

Transferring files via FTP

When transferring files, we recommend that you use FTP with Pretty Good Privacy (PGP) or GNU Privacy Guard (GPG). Alternatively, you may also use Secure FTP (sFTP). For more information, please see the requirements.

To submit a file for processing to the inbound directory:

  1. Obtain a username and password for the FTP Host and Worldpay eComm Pre-Live testing environment from your Implementation Manager.

  2. On your local system, add the extension .prg to the file you want to submit (for example, MerchantName_YYMMDD.prg). Please note:

    • Spaces are not allowed in the file name
    • The .prg extension must be lower case

  3. Open your FTP connection to the Worldpay inbound directory and move your file to the Worldpay directory.

Important

When submitting a file via FTP/sFTP, verify you set the file permission to 664.

  1. Change the extension of the file in the Worldpay inbound directory from .prg to .asc.

    Info

    File naming conventions are crucial to the file submission process. Incorrect file names prevent us from processing the file or may stop processing due to an incomplete file transfer:

    • Do not append .asc to the end of the filename
    • You must replace the .prg extension with .asc
    • If .prg appears in the filename, the system will not process the file
    • Limit the length of the filename to a maximum of 128 characters, including the extension

  2. Depending on the size of your file, your response should be ready within a few minutes. Batch files containing large number of transactions can take up to 10 minutes to process.

Retrieving processed files via sFTP

You receive an initial response from us, acknowledging we received the transactions and will deliver them upstream to the card networks.

Info

It is possible you will receive a declined response, because we validate against both the card number and expiration date.

To retrieve response files from the outbound directory:

  1. Open your FTP connection to our outbound directory.

  2. Locate the response file, which has the same name as the submitted file.

    Info

    If the response file has a .prg extension, it is still transferring and is not ready for retrieval. The extension changes to .asc when the transfer is complete.

  3. Retrieve the response file.

    Info

    Worldpay removes response files from the outbound directory after 24 hours.

Next steps

Testing Credit Card Transactions