Overview
General information
The request and response bodies are transmitted in JSON format, where the main ISO 20022 message in XML format is placed in the document_body field.
The type of the transmitted document is specified in the document_type field.
The following versions of ISO 20022 messages are supported:
• pain.001.001.12 — CustomerCreditTransferInitiationV12 (payment initiation)
• pain.002.001.14 — CustomerPaymentStatusReportV14 (payment status report
Error Codes
| Code | Description |
|---|---|
| 1001 | More than 500 payment instructions uploaded in a single request. |
| 9403 | ISO 20022 document validation error (does not conform to XSD schema). |
| 9999 | Internal server error related to document processing. |
ISO 20022 Validation Error Codes:
| Error Code | Description |
|---|---|
| BE04 | MsgId is missing or exceeds 35 characters. Must be non-empty and unique. |
| BE04 | CreDtTm is missing or has an invalid format. Expected format: YYYY-MM-DDThh:mm:ssZ. |
| AM04 | NbOfTxs is missing, non-integer, or ≤ 0. Must be a positive integer. |
| AM04 | CtrlSum is missing, < 0, or has more than 2 decimal places. |
| BE04 | InitgPty/Nm is missing or contains invalid characters. |
| BE04 | PmtInfId is missing or exceeds 35 characters. |
| RC01 | PmtMtd value is missing or not equal to “TRF”. |
| AM04 | NbOfTxs is missing, non-integer, or ≤ 0. |
| AM04 | CtrlSum < 0 or has more than 2 decimal places. |
| BE04 | InstrPrty is missing or not valid. |
| BE04 | Invalid date format. Required ISO format: YYYY-MM-DD. |
| BE04 | Dbtr/Nm is missing or contains invalid characters. |
| AC01 | Invalid IBAN: length or format does not match the country standard (e.g., KZ...). |
| BE04 | EndToEndId is missing, not unique, or exceeds 35 characters. |
| AM04 | InstdAmt is missing, ≤ 0, or has more than 2 decimal places. |
| RC01 | BIC is missing or does not match the format (A–Z/0–9 only, length 8 or 11). |
| BE04 | Cdtr/Nm is missing or contains invalid characters. |
| AC01 | Recipient IBAN is invalid — length or checksum does not match format. |
| BE04 | Payment purpose is missing or contains invalid characters. |
| BE04 | KBE code is missing or does not match the directory. |
| BE04 | IIN/BIN is missing or not 12 digits long. |
Statuses
Possible ISO 20022 settlement section statuses:
| ISO Code | Internal Status | Description |
|---|---|---|
| ACSC | success | Successfully sent to the bank |
| ACSP | process | In queue for processing |
| RJCT | error | Sending error, possibly rejected by the bank |
| PDNG | downloaded | Uploaded but not yet processed |
Restrictions
Modified at 2025-07-11 11:35:14