When integrating with Belfius Bank APIs via Token.io, you may encounter various error codes. Below, we detail some of the most common error codes to help you troubleshoot issues. For a comprehensive list of error codes, please visit the Belfius Bank Developer Portal here.
What do these error codes mean?
|
HTTP status codes |
Error |
Error-code |
Error-description |
Scenario |
|---|---|---|---|---|
| 400 |
MISSING_INPUT |
GEN-1201-100002 |
Missing required body/path/query input 'INPUT' |
Request received without a mandatory input in the body/path/query |
| 400 |
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. |
| 401 |
FAILED_SECURITY_VALIDATION |
GEN-1203-100003 |
Invalid access token |
Request received with invalid access_token. |
| 401 |
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 |
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 |
| 403 |
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 |
| 403 |
FORBIDDEN |
B14821ZZ-2101-000000 |
Customer profile does not permit this action |
Forbidden request due to the customer profile (limit reached, beneficiary country not allowed, …). This error is normally thrown when the client initiates a non-BE payment. This is a security feature. If a client wants to initiate a payment to another country other than Belgium, they have to go on their web channel and change this feature in their security profile. There, the client can whitelist countries. |
| 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 |
| 500 |
OTHER_API_ERRORS |
GEN-1206-100004 |
Internal error occurred |
Internal server error |
| 503 |
SERVICE_UNAVAILABLE |
GEN-1204-100001 |
Service is unavailable |
Planned down-time in currently on going |