Error Scenarios

Feezback Links Error Responses

The LGS returns errors in the following format:

Status: 400
Body: {"error": "Bad Request", "error_code": <CODE>}

Error code reference

CodeNameDescriptionTroubleshooting
1001
MAX_
REDIRECT_
LENGTH_
EXCEEDED
The redirect link provided has exceeded the maximum allowed length.
Ensure your redirect URL is concise and within the allowed character limit.
1002
INVALID_
ISSUER_
FORMAT
The issuer format is invalid.
Issuer must follow the format tpp/{iss_name}. Check your issuer string format.
1003
UNKNOWN_
API_
ENDPOINT
The API endpoint requested does not exist.
Only /token and /link are valid endpoints. Verify your API request URL.
1004
PUBLIC_
KEY_
NOT_
FOUND
The system could not locate a public key configured for your client.
Contact support to ensure your public key is properly configured.
1005
INVALID_
JWT
The JWT token provided is invalid.
This may occur if the token is expired, improperly formatted, or signed with the wrong key. Check your JWT generation process.
1006
CREDITOR_
ACCOUNT_
IS_
NOT_
WHITELISTED
The creditor account (IBAN/BBAN) is not on the whitelist.
Only whitelisted accounts can be used. Contact support to add the account to the whitelist.
1007
CREDITOR_
ACCOUNT_
IS_
NOT_
CONFIGURED
Feezback has not configured whitelisted creditors for your client.
Contact Feezback support to configure whitelisted creditors for your client account.
1008
NO_
FLOW_
CLAIM
The flow claim is missing from the request.
The flow claim is mandatory in certain processes (e.g., AIS process). Add the required flow claim to your request.
1009
WRONG_
ISSUER_
FOR_
API_
ENDPOINT
The incorrect issuer type was used for the API endpoint.
To access the /token endpoint, you must use {srv}/tpp as the issuer, not {srv}/user.
1010
NOT_
TRUSTED_
CUSTOMER_
VALIDATION_
FAIL
Customer validation failed for a client without a license.
Ensure your customer account has the proper licensing, or contact support for verification.
1011
FAST_
PSU_
ID_
VALIDATION_
FAIL
PSU ID validation for "fast" flow (payment) has failed.
Verify the PSU ID being used for fast payment flow is correct and properly formatted.
1012
NO_
TOKEN
No token was provided in the request.
Include a valid token in your request header.
1013
INVALID_
JWT_
CLAIMS
The claims within the JWT are invalid.
Check that all required claims are present and properly formatted in your JWT.

Best Practices

  • Always validate your JWT before sending
  • Ensure your redirect URLs are properly encoded and within length limits
  • Double-check issuer format according to the endpoint you're accessing
  • Include all required claims in your JWT
  • Verify that creditor accounts are whitelisted before attempting production operations with them.


Did this page help you?