Card purchases and bank account direct debits can be processed in bulk by uploading a batch file.

📘

File Name

The file name must use the following format: [Prefix]-[Version]-[Type]-[Merchant Username]-[Date]-[Suffix].csv
For example: BATCH-v1-PURCHASE-acmeinc-20180131-1516337063.csv

Filename ComponentExample ValueDescription
PrefixBATCHThis value must always be "BATCH". It indicates that this is a batch processing file.
Versionv1The version of the batch file. This should currently be set to "v1".
TypePURCHASEThis indicates the type of records in the file. Use "PURCHASE", "REFUND" or "DIRECTDEBIT"
Merchant UsernameacmeincYour merchant username.
Date20180131The desired processing date for the batch. If the date provided is current or past, the batch will be queued for immediate processing.
Suffix1516337063Choose your own suffix for distinguishing between batches scheduled on the same date (e.g. file created timestamp in epoch time). This should be no longer than 15 characters.

🚧

File Format Requirements

The batch file must be in CSV format and use ASCII as the character set.

Each line must end in Carriage Return and Linefeed (CRLF).

The file must not contain any header or footer rows.

The data in the file must be text-types; i.e. if creating rows in Excel, ensure all cell types are set to Text to ensure numbers are not converted to scientific etc.

Validation

When a batch file is received for processing it will be validated and then enqueued to be processed on the batch date (or immediately if the date is the same as the upload date or a past date).

Processing & Completion

For batches which need to be processed as soon as they are received, the date in the filename should be set to the current date. If a batch is for a future date then this date should be used in the filename.

Batches which are for immediate processing will be started as soon as they are properly validated, however they may be queued behind other batches. For future dated batches, processing will commence at midnight, UTC+10 (or UTC+11 during AEDT) (14:00 UTC).

A results file can be downloaded which details the outcome of each transaction.