Version: current

Payout Error Codes

About this page

This page contains the codes of errors that may occur when you create a payout.

How it works

When an API call fails, EBANX will return a JSON object containing the error details as the example below:

"message":"Empty amount",

Observe the following table and verify the codes and error messages that EBANX uses.

HP-BI-01Could not decrypt API request field: Unable to decrypt ciphertext
HP-BR-01Merchant is not allowed to use PIXBrazil
HP-BR-02Empty PIX keyBrazil
HP-BR-03Invalid PIX keyBrazil
HP-BR-04PIX key should be equals to Payee document when it is CPF/CNPJBrazil
HP-CM-01Empty external reference
HP-CM-02The external reference must be between 6 and 40 characters long
HP-CM-03You already have a payout with this external_reference
HP-CM-04Empty country
HP-CM-05Country not found
HP-CM-06This country is not enabled
HP-CM-07This country is not enabled for your account
HP-CM-08Empty currency code
HP-CM-09Empty amount
HP-CM-10Invalid amount
HP-CM-11Amount must be greater than zero
HP-CM-12Invalid use_payee_hub value
HP-CM-13Empty bank name
HP-CM-14Invalid bank name
HP-CM-15Empty account type
HP-CM-16Invalid account type
HP-CM-18Empty bank account
HP-CM-19Empty bank branch
HP-CM-20Empty bank details
HP-CM-21Invalid bank detail [Operation code]
HP-CM-23Invalid bank account
HP-CM-24Payout is not available for savings account of bank '{$bank_name}'
HP-CM-25Bank account [CCI] should be 20 digits longPeru
HP-CM-26Bank account should be 11 digits longMexico
HP-CM-26Bank account should be 13 digits longArgentina
HP-CM-27Bank details [clabe] should be 18 digits longMexico
HP-CM-27Bank details [cbu] should be 22 digits longArgentina
HP-CM-28Unauthorized payee due to compliance issues
HP-CM-29Invalid payee data
HP-CM-30You already have a payout with this external_reference
HP-CM-31The payout amount exceeds the monthly limit for this Payee document
HP-CM-32The payout amount exceeds your total balance [Balance: {$balance_normalized}]
HP-CM-33Merchant is not enabled
HP-CM-34Empty payee name
HP-CM-35The payee name must be between 3 and 100 characters long
HP-CM-36Empty payee email
HP-CM-37Invalid payee email
HP-CM-38The payee email must be between 5 and 100 characters long
HP-CM-39The Payee is under age
HP-CM-40Invalid Payee document. You cannot update document
HP-CM-41Invalid document type. You cannot update document type
HP-CM-42Parameter bank_info should not be null
HP-CM-43Invalid bank document
HP-CM-44Empty UID and External Reference
HP-CM-45Payout not found
HP-CM-46Payout not found for this account
HP-CM-47Empty date range
HP-CM-48Invalid date_from
HP-CM-49Invalid date_to
HP-CM-50Date_to must be greater or equal to date_from
HP-CM-51Date range must be between 31 days
HP-CM-52Invalid page
HP-CM-53Invalid status
HP-CM-54Invalid per_page
HP-CM-55Payout status different than OP
HP-CM-56Payout cannot be cancelled after {$cancellation_time} minutes since the request
HP-CM-57Empty ID, Customer ID
HP-CM-58Payee not found
HP-CM-59Empty UID, Transfer Code, Settlement Code and External Reference
HP-CM-60Transfer not found
HP-CM-61Transfer not found for this account
HP-CM-62Transfer status different than OP
HP-CM-63Transfer cannot be cancelled after {$cancellation_time} minutes since the request
HP-CM-64Invalid Transfer source
HP-CM-65Customer parent must not be a child
HP-CM-66Child customer too deep to find root: {$max_child_level} or more levels found"
HP-CM-68HivePayoutType not defined with code '{$type}
HP-DF-01Empty request
HP-DF-02Invalid Expression
HP-DF-03Empty integration_key value
HP-DF-04Parameter integration_key is invalid
HP-DF-05Account is not enabled
HP-DF-06Invalid request type
HP-GN-01Internal server error
HP-GN-03Unexpected error occurred
HP-LL-01Invalid country and currency for local payout
HP-LL-02Invalid currency code for local payout
HP-LL-03Invalid Amount. Local Amount Total exceeded the maximum accepted amount
HP-TC-01Target not enabled for this country
HP-TC-02Target requested not found
HP-XB-01Invalid currency code for this country
HP-XB-02Invalid Amounts - Data:
HP-XB-03Invalid Amount. Local Amount Total exceeded the maximum accepted amount
HP-XB-04Fee not found for this Payout, please contact your BizDev
HP-XB-05Empty payee birth_date parameter
HP-XB-06Parameter birth_date is invalid
HP-XB-07The payee document information doesn\'t match with the payee name or birth_dateBrazil
HP-XB-08The payee document is not valid with Brazil Federal RevenueBrazil
HP-XB-10Parameter address should not be null
HP-XB-11Parameter city should not be null
HP-XB-12Parameter zipcode should not be null
HP-XB-13Parameter state should not be null
HP-XB-14Parameter terms_accepted_at should not be null
HP-XB-15Parameter terms_accepted_at is invalid
HP-XB-16Invalid Shareholders
HP-XB-17Empty shareholder birth_date
HP-XB-18Invalid shareholder birth_date
HP-XB-19The shareholder is under age
HP-XB-20Parameter company contact name should not be null
HP-XB-21Parameter company contact document should not be null
HP-XB-22Invalid shareholder document
HP-XB-23Shareholder document doesn\'t match with its name or birthdayBrazil
HP-XB-24The shareholder document is not valid with Brazil Federal RevenueBrazil
HP-XB-25Invalid shareholder email
HP-XB-26Currency not found for this country
HP-XB-27Invalid shareholder document type
HP-XB-28Shareholder document cannot be equals to payee document
HP-XB-29Shareholder documents cannot be duplicated
HP-XB-30Parameter company contact document type should not be null
BP-HI-0001You already have a transfer with this external_reference
BP-HI-0002Amount must be greater or equal to {$minimum} USD
BP-HI-0003The transfer request limit per day was reached
BP-HI-0004The transfer request limit was reached
BP-HI-0005Invalid transfer source
BP-HI-0006Insufficient payment balance, {$percentage} USD available

Getting help

We hope this article was enlightening, but in case we’ve failed to take out your doubts you have the following options to keep on seeking for answers:

  • If you’re not our partner yet and would like to know more about our prices and conditions please fill ou this form and our comercial team will get in touch with you.
  • In case you’re already our partner please get in touch with our support team at
Last updated on by Fernando Pankiewicz Gomes