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.
The general minimum amount is 0,1€, for standing order to Belfius long Term Saving is 25€.

 

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.
Request received with non-Banx account if Banx end point is used.
(Banx will be decommissioned in December 2024)

 

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).
(Banx will be decommissioned in December 2024)

 

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.
Variable standing order are only allowed to Belfius Saving accounts

 

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.
(Banx will be decommissioned in December 2024)

 

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.
(Banx will be decommissioned in December 2024)

 

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.
(Banx will be decommissioned in December 2024)

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