Payment request endpoint errors

When using the Payment requests endpoint, you can receive different errors depending on the data inputs.

To avoid issues when sending a payment request to the bank, we proceed to several checks. 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.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	transactions[i].label	Transaction label is too long (XX characters max)
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)
bank.unsupported_capability	/	The selected bank does not support single_payment_scheduled, please try with another bank
bank.unsupported_operation	/	The selected bank does not support payment from a sandbox application, please try with another bank or from your production application
payment.bank_not_found	/	This bank does not exist or accept payments

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

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

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