Sends up to 10,000 transactions of a single type as an NDJSON stream: one JSON object per line,
Content-Type: application/x-ndjson.
Test environment: 50 transactions per batchOn
https://api-test.brinta.coma batch accepts only 50 lines. Lines after the 50th are
not processed and do not appear in the summary or the results. Production accepts up to 10,000.
The transaction type comes from the path, so every line in a batch has the same type:
| Path value | transaction_type in responses | Each line is validated as the body of |
|---|---|---|
sale | sale | POST /sales/ |
refund | refund | POST /refunds/ |
chargeback | chargeback | POST /refunds/ |
adjustment | adjustment | POST /refunds/ |
transfer | transfer | POST /transfers/ |
transfer-reversal | transfer reversal | POST /transfers/ |
to-settle | to settle | POST /transfers/ |
settlement | settlement | POST /transfers/ |
Each line is the body you would send to the single-resource endpoint, with two differences:
transaction_external_idis required. It correlates results with your records and
deduplicates retries.typemust not be sent. A line that includes it fails witherror_field: "type".
Brinta reads, validates and queues the lines as they arrive, then responds 202. Lines that
fail validation are recorded as failed and are not processed. The response carries the
batch_id; read the outcome with GET /batches/transactions/{batch_id} and
GET /batches/transactions/{batch_id}/results.
Lines over the limit are not readThe limit is 10,000 non-empty lines in Production and 50 in Test. Lines after the limit,
or past the request size limit, are not processed and do not
appear in the summary or the results. Split larger loads into several batches and check
thatsummary.totalmatches the number of lines you sent.
