Account API

Access account balance and transaction history of Belfius customers in total security.

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

302

Payment has to be signed

20010

signature_required

Valid payment request which needs to be signed by Belfius Application. Client must follow the Location header in response to sign the payment.

400

missing_input

10001

Missing required input 'INPUT'.

Request received without a mandatory parameter

 

invalid_input

10002

Input 'INPUT' is not valid. DETAILS OF WHAT IS WRONG.

Request received with bad parameters (invalid format) values

 

invalid_input

10008

Execution date must be in future.

Request received with execution-date in past

 

invalid_input

10009

Amount must be bigger than 0.

Request received with amount <=  0

 

invalid_input

10010

Currency has to be EUR.

Request received with currency other than EUR

 

invalid_input

10011

Sender and receiver account must not be same.

Request received with same account for sender and receiver

 

invalid_input

10013

Communication must be of exact 20 chars length for STRUCTURED communication.

Request received with commuication where communication_type='STRUCTURED' and communication length is different than 20

 

invalid_checkdigit

10018

Either Order/Beneficiary account is not in correct format OR structured communication is not valid.

Request received with Incorrect Order/Beneficiary account OR incorrect structured communication

 

invalid_input

10019

Execution date is not valid.

Request received with invalid execution-date (weekend e.g.)

401

failed_security_validation

10003

Validation failed for security related parameters. DETAILS OF WHAT IS WRONG.

Request received with invalid values for Oauth2 Security related parameters

 

invalid_access_token

10006

access_token is not valid.

Request received with invalid access_token

 

consent_expired

20008

Consent is expired. Client must call the url present in this response, associating a required state in the url, in order to renew the consent. In case the state query parameter has not been appended, client will receive an error/error-description (0100/0STATE) for missing state parameter.\" ,\n
                \"url\": \"https://www.belfius.be/common/fr/fw/generic/launcher.html?appkey=PSD2_RENEWAL&apptoken=rdger6e5325drte5635trwe45rew5wr345we5

Request received when associated consent has been expired.

403

blocked_tpp

20001

No Active TPP found.

Request received with a Client-ID(TPPID) which is not active

 

invalid_account

20002

No Account found.

Request received with non-belfius account

 

channel_not_permitted

20003

This account can not be consultated via electronical channel.

Request received with account 'not consultable with electronic channel'

 

account_not_supported

20004

This account is not allowed for this type of request.

Request received with account 'not allowed for PSD2'

 

no_active_consent

20005

User/System has deactivated the consent. Tpp has to start over with /consent-uris

Request received with the consent which has been deactivated by the user/system

 

access_denied

20006

Access is not ok for this account. Please contact customer support.

Request received with account for which access has been disabled by provider'

 

date_from_is_too_old

20007

Transaction history older than 90 days is not possible.

Request received with date_from >90 days

 

duplicate_payment_id

20009

Duplicate payment-id.

Request received with already used payment-id

404

resource_not_found

10004

Specific version not found.  Supported versions are [X,..].

Request received with invalid version in Accept header

 

resource_not_found

10007

No account found with given logicalId.

Request received with invalid logicalId

 

resource_not_found

10102

Requested resource was not found.

Request received with unsupported HTTP verb

405

method_not_allowed

10103

Requested HTTP method is not allowed for this endpoint.

Request received with restricted HTTP verbs

406

unacceptable_media_type

10005

Server can not return the response In the format mentioned in the request. Supported type is application/vnd.belfius.api+json;.

Request received with invalid type in Accept header

415

unsupported_media_type

10012

Content-Type must be application/json.

Unsupported media type. Content-Type must be application/json

495

ssl_validation_error

10020

error during client authentication.

SSL certificate error. Mutual TLS can not be established. It may occur when an unregistered client( or a client with an invalid/expired certificate) trying to access a secure api

500

internal_server_error

20020

Internal error occurred.

Internal server error.

503

service_unavailable

10108

Service unavailable, please try after some time.

Client request falls in the configured 'restrict time period' frame

 

service_unavailable

10109

Service unavailable, please try in 24 hours.

Client request falls in the configured 'restrict day period' frame