Payment API

Initiate payments from a Belfius 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

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