Upload Transaction Batch File

POST https://{base_url}/v2/merchant/{merchantId}/transactionBatch

The Request Body must include a file namedtransactionsFile, which contains a batch of transaction details. The file should be in JSON format, with each entry representing a single transaction.

This endpoint is used to upload and validate a batch of transactions for a specified merchant. It performs general validation and mandatory field checks on the transaction data. If all validations pass, a success message is returned. Otherwise, detailed error messages are provided for any validation failures.

Headers

Name	Value
Content-Type	multipart/form-data
Authorization	Bearer <token>

Path Parameters

Name	Description
merchantId	Merchant Id for transaction batch file upload

Body

Name	Type	Required	Description
transactionsFile	File	True	A file that contains transactions

NOTE: The JSON file data structure inside will be the same as Upload Transaction Batch

Upload Transaction Batch File

Upload a file containing a batch of merchant transactions

POSThttps://{baseUrl}/api/v2/merchant/{merchantId}/transactionBatch

Authorization

bearerAuth

Path parameters

merchantId*string

Merchant Id for transaction batch file upload

Body

multipart/form-data

transactionsFilestring (binary)

Response

200400401500

Successful Response

Body

application/json

msgstring

Example: "Transactions processed"

resultsarray of object

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://{baseUrl}/api/v2/merchant/{merchantId}/transactionBatch', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "multipart/form-data"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401500

{
  "msg": "Transactions processed",
  "results": [
    {
      "status": "success",
      "msg": "text"
    }
  ]
}