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:

  1. Take merchantControlKey
  2. Remove dashes from it
  3. Unhex the result to binary