1.4.6. Batch file format¶
Batch file is a CSV file. Each line constitutes a single record. Lines are separated by newline character. Line consists of fields separated by commas.
Field value may be enclosed in double quotes (quoted). If field value contains a special character (newline character, comma, double quote), then field value MUST be quoted.
Double quotes inside a quoted field value must be doubled.
UTF-8 must be used as an encoding for data.
Requests must be signed. Signature is sent in X-Authorization HTTP request header.
Signatures are computed using HMAC_SHA1 algorithm; the request body (that is the whole batch file) is signed. Key is derived in the following way:
- Take merchantControlKey
- Remove dashes from it
- Unhex the result to binary