Payment API
Initiate payments from a payment account.
Error codes
The table below lists the possible exceptions (error scenarios), either caused by your request or by the API.
|
http status codes |
Error |
Error-code |
Error-description |
Scenario |
|---|---|---|---|---|
| 400 |
MISSING_INPUT |
GEN-1201-100001 |
Missing required header input 'INPUT' |
Request received without a mandatory input in the header |
|
|
MISSING_INPUT |
GEN-1201-100002 |
Missing required body/path/query input 'INPUT' |
Request received without a mandatory input in the body/path/query |
|
|
INVALID_INPUT |
GEN-1202-100001 |
Invalid request header input. |
Request received with bad input (invalid format) values in the header |
|
|
INVALID_INPUT |
GEN-1202-100002 |
Invalid request body/path/query input. |
Request received with bad input (invalid format) values in the body/path/query |
|
|
MISSING_INPUT |
B14821ZZ-1200-000000 |
Missing mandatory input fields |
Request received without a mandatory input field. Please check if endtoend_identification is filled in |
|
|
INVALID_INPUT |
B14821ZZ-1227-000000 |
Beneficiary's country is not allowed |
Request received with a country code that is not allowed |
|
|
INVALID_INPUT |
B14821ZZ-1231-000000 |
The amount must be higher than 0 |
Request received with an incorrect amount. The amount should be greater than 0. |
|
|
INVALID_INPUT |
B14821ZZ-1232-000000 |
The transaction's currency is invalid or not authorised |
Request received with an incorrect transaction currency. |
|
|
INVALID_INPUT |
B14821ZZ-1236-000000 |
BBAN-structure in combination of a BIC code is not authorised |
Request received with an account in BBAN structured and a BIC code. This is not authorized |
|
|
INVALID_INPUT |
B14821ZZ-1259-000000 |
The begin date must be in the future |
Request received with a begin date that is not in the future |
|
|
INVALID_INPUT |
B14821ZZ-1322-000000 |
The month of the end date should be according to the periodicity |
Request received with an incorrect end date of the standing order |
|
|
INVALID_INPUT |
B14821ZZ-1345-000000 |
The end date date must be later than the begin date |
Request received with an end date that is invalid. The end date should be after the begin date |
|
|
INVALID_INPUT |
B14821ZZ-1443-000000 |
The amount of the standing order is below the minimum amount allowed |
Request received with an amount that is below the allowed minimal amount. |
|
|
INVALID_INPUT |
B14821ZZ-2102-000000 |
Beneficiary's BIC is invalid or is missing |
Request received with the BIC code that does not match with the mentioned beneficiary IBAN or without a BIC code. Beneficiary BIC code can be a mandatory input for some countries/currencies. Please check our "flow" section for more information. |
|
|
MISSING_INPUT |
B14821ZZ-2103-000000 |
Fedwire (bank_national_id) is mandatory for this countries/currencies |
Request received without a Fedwire (Nat-ID). This is a mandatory input for some countries/currencies. Please check our "flow" section for more information. |
|
|
MISSING_INPUT |
B14821ZZ-2104-000000 |
Communication is a mandatory field for this country |
Request received without a communication field. This is a mandatory input for some countries/currencies. Please check our "flow" section for more information. |
|
|
MISSING_INPUT |
B14821ZZ-2105-000000 |
Beneficiary's name is missing |
Request received without a beneficiary's name. |
|
|
INVALID_INPUT |
B14821ZZ-2106-000000 |
This currency is not authorised for this country |
Request received with an unauthorized currency for this country. Please check our "flow" section for more information. |
|
|
MISSING_INPUT |
B14821ZZ-2107-000000 |
The purpose code is a mandatory field for this country |
Request received without a purpose code. This is a mandatory input for some countries/currencies. Please check our "flow" section for more information. |
|
|
INVALID_INPUT |
B14821ZZ-2110-000000 |
The charge bearer should be "SHAR" for payment initiation within the EEA |
Request received with an incorrect charge bearer. For payment initiation within the EEA, "SHAR" should be used |
|
|
INVALID_INPUT |
B14821ZZ-2111-000000 |
The country code filled in the beneficiary's addree does not match the entered BIC |
Request received with a country code that does not match the entered BIC code. BIC code of the beneficiary should refer to a bank present in the country of the beneficiary |
|
|
MISSING_INPUT |
B14821ZZ-2113-000000 |
BIC code is mandatory for payment to the US with currency other than USD |
Request received without a BIC code for the beneficiary account. This is mandatory for all payments to the US done with a currency other than USD. Please check our "flow" section for more information. |
|
| MISSING_INPUT |
B14821ZZ-2114-000000 |
BIC code or Fedwire (bank_national_id) is mandatory for payment to the US with currency USD |
Request received without a BIC code or a Fedwire (bank_national_id) for the beneficiary account. This is mandatory for all payments to the US done with a currency USD. Please check our "flow" section for more information. |
|
| INVALID_INPUT |
B14821ZZ-2117-000000 |
The transaction amount should be higher than 0 |
Request received with an incorrect transaction amount. |
|
| INVALID_INPUT |
B14821ZZ-2118-000000 |
Number of decimal for the transaction amount is exceed |
Request received with too many decimal in the transaction amount. |
|
| MISSING_INPUT |
B14821ZZ-2119-000000 |
The beneficiary country is mandatory |
Request received without a country. |
|
| INVALID_INPUT |
B14821ZZ-2124-000000 |
The ordering account is invalid or unusable |
Request received with an invalid or incorrect ordering account or with an account that cannot be used for PSD2 or with an account that is to be closed. |
|
| INVALID_INPUT |
B14821ZZ-2125-000000 |
The fedwire (bank_national_id) and BIC do not refer to the same bank |
Request received with a fedwire (national_bank_id) and BIC that do not refer to the same bank. |
|
| MISSING_INPUT |
B14821ZZ-2126-000000 |
All the beneficiary's address data must be filled out for this country |
Request received with an incomplete address data. For some destination country, the complete beneficiary's address should be given. Please check our "flow" section for more information. |
|
| INVALID_INPUT |
B14821ZZ-2134-000000 |
This currency is not allowed |
Request received with an ordering currency that is not allowed for this account. The ordering account does not have a compartment of this currency. Transaction currency is different from both ordering and beneficiary currency. |
|
| INVALID_INPUT |
B14821ZZ-2170-000000 |
Incorrect beneficiary account |
Request received with incorrect beneficiary account |
|
| INVALID_INPUT |
B14821ZZ-2171-000000 |
Incorrect currency for this payment product |
Request received with incorrect currency for the requested payment product |
|
| INVALID_INPUT |
B14821ZZ-2173-000000 |
Execution date invalid or is not allowed |
Request received with an execution date which is not allowed or invalid (should be in the future - maximum one year in the future- and should be an open business day) |
|
| INVALID_INPUT |
B14821ZZ-2174-000000 |
Incorrect structured communication |
Request received with an incorrect structured communication field value |
|
| INVALID_CHECKDIGIT |
GEGC0001-INPU-CHKDG |
Either the account or the structured communication contains an invalid checksum |
Request received with Incorrect Order/Beneficiary account OR incorrect structured communication |
|
| INVALID_INPUT |
GEGC0001-INPU-LENGTH |
The length of the field is incorrect |
Request received with a field that has an incorrect length |
|
| INVALID_INPUT |
GEGC0001-BASU-BTCONV |
The introduced amount is too big |
Request received with an invalid amount (too big) |
|
| BACKEND_ERROR_OCCURED |
B14821ZZ-2160-000000 |
Backend error occured |
Undefined backend error occured. Please contact the TPP support |
|
| BACKEND_ERROR_OCCURED |
B15586ZZ-2200-000000 |
Backend error occured |
Undefined backend error occured. Please contact the TPP support |
| 401 | FAILED_SECURITY_VALIDATION |
GEN-1203-100002 |
Signature is invalid |
Request signed with an invalid signature |
|
| FAILED_SECURITY_VALIDATION |
GEN-1203-100003 |
Invalid access token |
Request received with invalid access_token. |
|
| FAILED_SECURITY_VALIDATION |
GEN-1203-100008 |
Validation failed for security related parameters |
Request sent with invalid security parameter |
|
| FAILED_SECURITY_VALIDATION |
GEN-1203-100009 |
Invalid Api-Key/Client-ID |
Request received with invalid Client-ID or TPP-ID |
|
| FAILED_SECURITY_VALIDATION |
GEN-1203-100010 |
Invalid JWT |
Request received with an incorrect JWT token. This error can be linked to an incorrect logical-ID, an incorrect SCA token or PIS token |
|
| SCA_REQUIRED |
B14800ZZ-0PLC-REDRCT |
SCA is required. Please follow the corresponding URL in the response body. |
In AIS context, this error can be linked to an SCA that should be renewed (to access the account transaction) or because the PSU wants to access transactions that happened more than 90 days in the past. In PIS context, a SCA should be performed to sign the payment initiation |
| 403 | INVALID_TPP |
B14663ZZ-2100-000000 |
No Active TPP found. |
Request received with a Client-ID which is not active |
|
| INVALID_REFERENCE |
B15909ZZ-2180-000000 |
No transaction found |
Request received with an invalid reference. |
|
| INVALID_REFERENCE |
B15586ZZ-1410-000000 |
No transaction found |
Request received with an invalid reference. |
|
| INVALID_REFERENCE |
B15586ZZ-2180-000000 |
No transaction found |
Request received with an invalid reference. |
|
| INVALID_ACCOUNT |
B14800ZZ-3002-000000 |
No Account found. |
Request received with non-Belfius account if Belfius end point is used. |
|
| ACCESS_DENIED |
B14800ZZ-3004-000000 |
Access is not ok for this account. Please contact customer support. |
Request received with an account for which access has been disabled by provider. Please contact Belfius customer service |
|
| CHANNEL_NOT_PERMITTED |
B14800ZZ-3007-000000 |
This account can not be consulted via electronical channel. |
Request received for an account that is not consultable with electronic channel or request received for a Banx account using the Belfius endpoint or vice versa (Belfius account using Banx endpoints). |
|
| ACCOUNT_NOT_SUPPORTED |
B14800ZZ-3008-000000 |
This account is not allowed for this type of request. |
Request received for an account that is 'not allowed for PSD2' |
|
| FORBIDDEN |
B14800ZZ-3018-000000 |
Customer profile does not permit this action |
Forbidden request due to the customer profile (limit reached, beneficiary country not allowed, …) |
|
| MORE_SIGNATURE_REQUIRED |
B14800ZZ-3019-000000 |
This transaction needs more than one signature. |
Request transaction needs multiple level of signatures or authorizations |
|
| FORBIDDEN |
B14821ZZ-1446-000000 |
A variable standing order is not allowed for this type of beneficiary account |
Request to a beneficiary account that is not allowed when creating a standing order. |
|
| FORBIDDEN |
B14821ZZ-2101-000000 |
Customer profile does not permit this action |
Forbidden request due to the customer profile (limit reached, beneficiary country not allowed, …) |
|
| FORBIDDEN |
B14821ZZ-2116-000000 |
The transaction costs exceed the transaction amount. |
This payment initiation request generates a cost that exceed the transaction amount. This error message is only given for cross-border-credit-transfer. For sepa-credit-transfer and instant-sepa-credit-transfer this information will not be given. |
|
| FORBIDDEN |
B15586ZZ-2181-000000 |
Transaction is already cancelled |
Request received with transaction id which is already cancelled |
|
| FORBIDDEN |
B15586ZZ-2182-000000 |
Transaction is not initiated successfully. |
Request received with transaction id which is ot initiated successfully |
|
| FORBIDDEN |
B15586ZZ-2183-000000 |
Transaction cannot be cancelled |
Request received on a transaction that cannot be cancelled. The status of the payment initiation does not allow the cancellation. |
|
| FORBIDDEN |
B15586ZZ-2198-000000 |
Non Sepa payment initiation cannot be cancelled |
Non Sepa payment initiation cannot be cancelled |
|
| FORBIDDEN |
B14821ZZ-2480-000000 |
Variable standing order is not allowed for Banx accounts |
Request received for a Banx account for which creating a variable standing order is not allowed. |
|
| FORBIDDEN |
B16658ZZ-2300-000000 |
File cannot be cancelled |
Request received on a file that cannot be cancelled. The status of the file initiation does not allow the cancellation. |
|
| DUPLICATE_REFERENCE |
B14821ZZ-2150-000000 |
Duplicate end-to-end reference |
Duplicate end-to-end reference |
|
| INVALID_ACCOUNT |
B14821ZZ-2172-000000 |
Order account is not allowed to execute this payment product |
Request received with an order account which is not allowed to do the payment product |
|
| INVALID_PAYMENT |
B14821ZZ-1451-000000 |
The creation of a standing order with single payment is not authorized |
Request received to create a standing order with only one payment. This is not allowed. |
|
| INVALID_PAYMENT |
B14821ZZ-2112-000000 |
Payment to this country with this purpose code is not allowed. |
Request received with a combination of country/currency that is not allowed. Please check our "flow" section for more information. |
|
| INVALID_PAYMENT |
B14821ZZ-2121-000000 |
Non Sepa payment is not allowed for this account |
Request received for an account for which non sepa payment is not allowed |
|
| INVALID_PAYMENT |
B14821ZZ-2128-000000 |
Cut-off time to initiate non sepa payment has passed |
Request received outside the business hours. Non sepa payment cannot be initiated as the transaction costs cannot be calculated |
|
| INVALID_PAYMENT |
B14821ZZ-2129-000000 |
The payment product is not correct. The inputs are linked to a sepa-credit-transfer |
Request received with input fields linked to a sepa-credit-transfer. The payment product should be adapted in consequences. |
|
| INVALID_PAYMENT |
B14821ZZ-2135-000000 |
The payment product is not correct. The inputs are linked to a cross-border-credit-transfer |
Request received with input fields linked to a cross-border-credit-transfer. The payment product should be adapted in consequences. |
|
| INVALID_ACCOUNT |
B14821ZZ-2175-000000 |
Request received for a Banx account using the Belfius endpoint or for a Belfius account using Banx endpoints. |
Request received for a Banx account using the Belfius endpoint or for a Belfius account using Banx endpoints. |
|
| INVALID_PAYMENT |
B14821ZZ-2176-000000 |
Urgent Payment is not permitted when the order and the beneficiary account are both Belfius account Urgent payment |
Request received when both order and beneficiary accounts are Belfius accounts is not permitted. The payment instruction_priority should be NORMAL |
|
| INVALID_PAYMENT |
B14821ZZ-2177-000000 |
Cut-off time to initiate urgent payment has passed |
Cut-off time to initiate urgent payment has passed |
|
| INVALID_PAYMENT |
B14821ZZ-2178-000000 |
Instant payment initiation between Belfius or Banx accounts is not possible |
Request received with the orderer and the beneficiary account that are Belfius or Banx account. Instant payment initiation is not possible in this case, a sepa-credit-transfer should be used |
|
| INVALID_PAYMENT |
B14821-2179-000000 |
The beneficiary bank does not support instant payment. Instant payment initiation to this beneficiary account is therefore not possible. |
Request received with a beneficiary account in a bank that does not support instant payment. Instant payment initiation is not possible in this case, a sepa-credit-transfer should be used |
|
| INVALID_PAYMENT |
B14821ZZ-2180-000000 |
Instant payment should be executed directly. Execution date cannot be in the future. |
Request received with an incorrect execution date (should not be in the future) |
|
| INVALID_PAYMENT |
B14800ZZ-3023-000000 |
Urgent payment is not allowed for this type of account. |
Request received for an account for which urgent payment is not allowed. |
|
| INVALID_PAYMENT |
B14800ZZ-3024-000000 |
Non-Sepa payment is not allowed for Banx accounts. |
Request received for a Banx account for which non-sepa payment is not allowed. |
| 404 | OTHER_API_ERRORS |
GEN-1206-100001 |
Requested resource was not found. |
Request received with unsupported HTTP verb |
|
| OTHER_API_ERRORS |
GEN-1206-100002 |
Specific version not found. Supported versions are 'INPUT' |
Request received with invalid version in Accept header |
| 405 | OTHER_API_ERRORS |
GEN-1206-100003 |
Method not allowed |
Request received with restricted HTTP verbs |
| 406 | OTHER_API_ERRORS |
GEN-1206-100006 |
Server cannot return the response In the format mentioned in the request. Supported type is: 'INPUT' |
Request received with invalid type in Accept header |
| 429 | API_USAGE_LIMIT_REACHED |
GEN-1205-100001 |
Rate limit exceeded |
Request received during Sepa Payment API call with client-ID which has exceeded the rate limit |
| 495 | FAILED_SECURITY_VALIDATION |
GEN-1203-100001 |
SSL validation error |
SSL certificate error. Mutual TLS cannot be established. It may occur when an unregistered client( or a client with an invalid/expired certificate) trying to access a secure api |
| 500 | OTHER_API_ERRORS |
GEN-1206-100004 |
Internal error occurred |
Internal server error |
|
| OTHER_API_ERRORS |
GEN-1206-100008 |
Internal error occurred with reason : |
Internal error occurred with reason : |
| 503 | SERVICE_UNAVAILABLE |
GEN-1204-100001 |
Service is unavailable |
Planned down-time in currently on going |
