Skip to content

↑↓ navigate ↵ open Ctrl↵ new tab esc close
CodeMeaning
200Success (GET, PATCH, batch)
201Transaction created (single POST)
401Missing or invalid credentials
403Company blocked, or no product that uses transactions is active (creation only)
404Transaction or merchant not found
405Transactions cannot be deleted (DELETE), see Delete transaction
409Conflict (duplicate, or update of an immutable transaction)
422Validation error (invalid fields)
429Too many requests (limit: 100 per minute per IP)
500Internal server error

Every error response follows the same format:

{
"error": {
"code": "ERROR_CODE",
"message": "Error description"
}
}

CodeHTTPMessage
UNAUTHORIZED401Missing or invalid Authorization header
UNAUTHORIZED401Invalid Basic Auth format
UNAUTHORIZED401Missing client_id or client_secret
UNAUTHORIZED401Invalid credentials
COMPANY_BLOCKED403Company is blocked
CodeHTTPMessage
VALIDATION_ERROR422Validator message (e.g. card_last4 must be exactly 4 digits)
CodeHTTPMessage
TRANSACTION_NOT_FOUND404Transaction not found
TRANSACTION_DUPLICATE409Transaction already exists
TRANSACTION_DUPLICATE409Another transaction with this external_source/external_id already exists
TRANSACTION_IMMUTABLE409Transaction cannot be modified: it has been used by a network event
TRANSACTION_DELETE_NOT_ALLOWED405Transactions cannot be deleted
MERCHANT_NOT_FOUND404Merchant not found
PRODUCT_NOT_ACTIVE403Transactions require an active Prevention or Dispute product

PRODUCT_NOT_ACTIVE only shows up on creation (POST /transactions and POST /transactions/batch), when the company has neither Prevention nor Dispute active. Retrieving and updating do not require an active product. See Who sends transactions.

CodeHTTPMessage
RATE_LIMIT_EXCEEDED429Rate limit exceeded, retry in X seconds

On the batch endpoint, individual errors are returned in the errors array inside data, without stopping the processing of the other transactions:

{
"data": {
"created": 1,
"failed": 2,
"results": [
{ "external_id": "TXN-2026-001", "tx_id": "uuid-1", "warnings": [] }
],
"errors": [
{ "index": 1, "external_id": "TXN-2026-002", "status": 409, "error": "Transaction already exists" },
{ "index": 2, "external_id": "TXN-2026-003", "status": 404, "error": "Merchant not found" }
]
}
}

The exception is 403 PRODUCT_NOT_ACTIVE: without an active Prevention or Dispute, the whole call is refused with 403 and no transaction is created. It does not show up in the errors array.

Each error includes:

  • index: position of the row in the array you sent, starting at zero.
  • external_id: identifies which transaction failed.
  • status: the equivalent HTTP code of the error.
  • error: descriptive message.