Search

Are you looking for test card numbers?

Would you like to contact support?

Developer-resource icon

Submit modifications in your Customer Area

Create and upload input files for batch processing of payment modifications.

If you require batch processing of payment modifications, the Customer Area offers the easiest way to get this done. Based on a simple CSV input file that you upload, the Customer Area will help you to complete missing details and fix errors in the input file. The Customer Area is able to help you with the following modifications:

  • Capture
  • Cancel
  • Refund
  • Cancel or refund

You can also submit authorisations in your Customer Area, but that requires a more complex input file that the Customer Area cannot help you with.

Before you begin

To submit files in the Customer Area for batch processing of modifications, ask your Admin user to enable the following role for you at the merchant account level:

  • Merchant submit batch modifications.

If you need to process modifications for multiple merchant accounts, contact our Support Team to enable this for you.

Create an input file

To provide details of the payment modifications you require, you need to prepare a CSV (Comma Separated Values) file as per RFC 4180 (with some exceptions), saved in UTF-8 format.

To create a valid CSV input file, keep to the following rules:

  • The file does not contain a header row.
  • Each modification is a separate record, on a separate line.
  • All records contain the same fields.
  • The records do not contain empty fields (null values).
  • Each record can contain the following fields:

    Field Description
    PSP reference REQUIRED The PSP reference of the payment you want to modify.
    Merchant account The merchant account that you want to process the modifications for.
    Modification Type of modification. Allowed values: authoriseReferral, capture, cancel, refund, or cancelOrRefund.
    Amount Transaction amount of the modification, in minor units.
    Currency Three-letter currency code.
    • If you don't provide a merchant account, we use the name of the account you're uploading the input file from.
    • If you don't provide the modification, amount, or currency, you can use the Customer Area to add these fields. However, that would set the same value for all records.

Example input file:

YOUR_MERCHANT_ACCOUNT,8825579775423213,refund,1000,EUR
YOUR_MERCHANT_ACCOUNT,852557977271760C,refund,10000,EUR
YOUR_MERCHANT_ACCOUNT,853557726309420J,capture,19123,EUR
YOUR_MERCHANT_ACCOUNT,8515572949781132,capture,4000,EUR
YOUR_MERCHANT_ACCOUNT,8535572942929833,refund,1000,GBP
YOUR_MERCHANT_ACCOUNT,8535572933671543,refund,1000,GBP
YOUR_MERCHANT_ACCOUNT,8515571184680843,refund,6000,NOK
YOUR_MERCHANT_ACCOUNT,8825579787887769,refund,2700,SGD
YOUR_MERCHANT_ACCOUNT,8825571079892854,cancelOrRefund,1000,EUR

Upload modifications

  1. Create a CSV input file containing at least the PSP references of the payments you want to modify.
  2. Log in to your Customer Area.
  3. Switch to your merchant account.
  4. Go to Finance > Batches.
  5. Select Upload File, then select your CSV input file and select Submit.
  6. Under Review Batch check for any errors:

    • If there are no errors, you'll see an overview of the batch, with the number of modifications and their total value.

    • "Incomplete data": all records in the input file are missing one or more fields.
      You can add the missing fields in the input file and then upload the file again.
      Or you can add the missing fields in the Customer Area, as described in the next step.

    • Other errors: fix the input file based on the error description, and upload the file again.

  7. To fix an Incomplete data error by adding missing fields in the Customer Area:

    All records will get the same value for the added field.

    1. Select the + button. A dialog appears.
    2. In the Column field, select the field that is missing from the records.
    3. In the Fixed Value field, select the value to assign to the field, or enter an amount in minor units.
    4. Select Add Column.
    5. Repeat as needed if more fields are missing from the records.
  8. Select Upload.
    The batch is QUEUED, and then PROCESSED.

See also