Consent API

Obtain the tokens necessary to call the PSD2 APIs

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

401

FAILED_SECURITY_VALIDATION

GEN-1203-100004

invalid refresh token

Request received with an invalid refresh_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

403

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)

 

CHANNEL_NOT_PERMITTED

B14800ZZ-3007-000000

This account can not be consultated 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)

 

NO_ACTIVE_CONSENT

B14800ZZ-3013-000000

User has deactivated its consent in the channel. Tpp has to start over with /consent-uris flow

Request received with the consent which has been deactivated by the user within its Belfius or Banx channel
(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

 

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

 

OTHER_API_ERRORS

GEN-1206-100003

Method not allowed

Request received with restricted HTTP verbs

495

FAILED_SECURITY_VALIDATION

GEN-1203-100001

SSL validation error

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

 

FAILED_SECURITY_VALIDATION

GEN-1203-100001

SSL validation error

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

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 :

 

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

 

SERVICE_UNAVAILABLE

GEN-1204-100001

Service is unavailable

Planned down-time in currently on going