Payment request endpoint errors

When using the "Payment request" endpoint, you can receive different errors depending on the data you set in the input.

To avoid issues when sending the the payment request to the bank, we proceed to several verifications. If the body contains some errors, we will list the errors in the response, like this:

{
  "errors": [
    {
      "code": "payment.user.name_missing",
      "property": "user.name",
      "message": "User name is missing"
    },
    {
      "code": "payment.transaction.amount_missing",
      "property": "transactions[0].amount",
      "message": "Transaction amount is missing"
    }
  ]
}

Here is the complete list of errors you can get:

Code	Property	Message
payment.invalid_callback_url	/	"The successful_callback_url is not whitelisted" or "The unsuccessful_callback_url is not whitelisted"
payment.successful_callback_url_missing	successful_callback_url	Successful callback url is missing
payment.transaction.amount_missing	transactions[i].amount	Transaction amount is missing
payment.transaction.amount_too_many_decimals	transactions[i].amount	Transaction amount must not have more than 2 decimal places
payment.transaction.max_amount	transactions[i].amount	Transaction amount must be lower or equal than 35000
payment.transaction.currency_missing	transactions[i].currency	Transaction currency is missing
payment.transaction.label_missing	transactions[i].label	Transaction label is missing
payment.user.name_missing	user.name	User name is missing
payment.user.ip_address_missing	user.ip_address	User Ip address is missing
payment.transaction.external_merchant_invalid	transactions[i].external_merchant_id	Transaction external_merchant_id is invalid or empty (only 35 characters, letters and digits only)
payment.transaction.label_too_long	/	Transaction's label at index 0 is too long (XX characters max allowed by selected bank)
payment.user.name_too_long	user.name	User name is too long (35 characters max)
payment.user.ip_address_invalid	user.ip_address	User Ip address must be IPv4 or IPv6 format
payment.user.external_reference_invalid	user.external_reference	User external_reference is invalid (only 35 characters, letters and digits only)

You will get a different error if you do not provide a bank_id, if you provide a bank_id not compatible with payments or if the bank_id you provide does not match with any of our bank.

{
    "type": "invalid_request",
    "message": "Missing bank_id",
    "documentation_url": null
}

Type	Message
invalid_request	Missing bank id
invalid_request	No bank matches the provided bank_id
invalid_request	This bank is not supported for payments