Table containing all possible error responses returned by our API.
The table below provides a complete reference for every standardized error that can be returned by our API endpoints. Each entry includes the error’s numeric code, its label (key) used in API responses, and a detailed description of the corresponding message.
Please, use this table as a guide for error handling, logging, and user feedback, ensuring consistent integration behavior and easier debugging.
| Code | Label | Detail |
|---|---|---|
| 0001 | server.error | Internal error |
| 0002 | country.not.integrated | It's not possible to transact with this country yet. |
| 0003 | not.found | Not found |
| 0004 | required.field | Required field. |
| 0005 | street.address.invalid | The informed street is invalid. |
| 0006 | without.authorization | Without authorization. The auth code is wrong. |
| 0007 | user.not.found | Beeteller User not found. |
| 0008 | unavailable.bank | The informed bank does not accept transfers in this format. |
| 0009 | unavailable.balance | Your account has no balance. |
| 0010 | unavailable.query | Resource not available now. Try again in few seconds. |
| 0011 | outside.operational.limit | This value is outside our operating limits. |
| 0012 | zipcode.size | The zip code must have 8 numeric digits. |
| 0013 | document.size | The CPF document must have 11 numeric digits. |
| 0014 | document.number.size | The document must have 11 numeric digits. |
| 0015 | document.invalid | The document informed must be a valid CPF or CNPJ. |
| 0016 | document.bank.account.same.user | The bank account document must be the same as the user document informed. |
| 0017 | document.pix.key.same.user | The Pix key owner must be the same as the user document informed. |
| 0018 | document.bank.account.same.depositor | The bank account document must be the same as the depositor's document. |
| 0019 | account.digit.number.size | The account digit must have one numeric digit. |
| 0020 | account.number.invalid.type | The account number must have only numeric digit. |
| 0021 | brl.eur.possible.values | The only possible values are BRL and EUR |
| 0022 | generic.possible.values.are | The only possible values are %s |
| 0023 | generic.possible.values.is | The only possible values is %s |
| 0024 | param.cannot.be.negative | The 'param_name' parameter cannot be negative or zero |
| 0025 | param.cannot.be.less.than | The 'param_name' parameter cannot be less than %s |
| 0026 | param.cannot.be.empty | The 'param_name' parameter cannot be empty |
| 0027 | param.max.value | The max value of 'param_name' parameter is %s |
| 0028 | param.max.length | The max length of 'param_name' parameter is %d characters |
| 0029 | param.min.length | The min length of 'param_name' parameter is %d characters |
| 0030 | generic.param.max.length | The max length is %d characters |
| 0031 | generic.param.min.length | The min length is %d characters |
| 0032 | param.required.length | Must has %d characters |
| 0033 | brl.possible.value | The only possible value is BRL |
| 0034 | invalid.currency | Invalid currency |
| 0035 | invalid.currency.in.country | Currency not allowed in the country |
| 0036 | invalid.value | Invalid value. |
| 0037 | invalid.max.min.value | Value is higher or lower than allowed max/min value |
| 0038 | invalid.param.type.must.be | Invalid type of parameter '%s'. Must be %s |
| 0039 | forbidden.currency | User does not have permission to use this currency |
| 0040 | payment.type.possible.values | The only possible values are BANK_SLIP and TRANSFER |
| 0041 | receipt.type.possible.values | The only possible values are RECEIPT, TED or PIX |
| 0042 | receiver.without.bank.account | This receiver does not have a registered bank account |
| 0043 | generic.only.numbers.error | Only numbers are acceptable |
| 0044 | invalid.payment.type | Invalid payment type or not allowed in the country |
| 0045 | payment.method.not.found | Payment method not found |
| 0046 | duplicated.transaction | Duplicated transaction |
| 0047 | invalid.not.found.payer | Payer not found or invalid. |
| 0048 | invalid.expiration.date | Invalid expiration date. |
| 0049 | invalid.date.format | Invalid date format. Current format: yyyy-mm-dd |
| 0050 | invalid.date.format.expected | Invalid date format. Expected format: '%s' |
| 0051 | invalid.birth.date | Invalid birth date |
| 0052 | invalid.email | Invalid e-mail. |
| 0053 | invalid.alpha.3.country.code | Invalid ALPHA-3 Country's code (ISO 3166-1) |
| 0054 | invalid.aplha.2.country.code | Invalid ALPHA-2 Country's code |
| 0055 | invalid.document.type | Invalid document type |
| 0056 | invalid.document.number | Invalid document number |
| 0057 | invalid.method | Invalid method |
| 0058 | invalid.bank.account | Invalid bank account |
| 0059 | invalid.bank.account.data | Invalid bank account type or number |
| 0060 | invalid.bank.code | Invalid bank code |
| 0061 | invalid.bank.branch | Invalid bank branch |
| 0062 | invalid.country.or.currency | Invalid country code or currency not acceptable in this country |
| 0063 | invalid.value.negative | The value must be higher than zero |
| 0064 | segmentation.without.permission | Your segmentation does not have the required permission |
| 0065 | generic.min.value | Order's value didn't reach the min limit value |
| 0066 | generic.max.value | Order's value overflows the max limit value |
| 0067 | generic.order.value.limit.error | Order's value is under or over the limit |
| 0068 | disabled.payment.method | At the moment, this payment method is disabled |
| 0069 | without.transactional.limit | Customer without transactional limit |
| 0070 | invalid.url.content | Invalid URL content |
| 0071 | generic.invalid.value | The value must be a valid number and higher than zero |
| 0072 | invalid.pix.key | Invalid Pix Key |
| 0073 | invalid.phone.number | Invalid Phone number |
| 0074 | pix.only.for.brl | Pix method is available only for BRL currency |
| 0075 | key.and.bank.account.payout.error | Pix key and bank account data cannot be informed simultaneously |
| 0076 | problems.with.pix.key | Pix Key with error or not found |
| 0077 | invalid.card.number | Invalid card number |
| 0078 | duplicated.card.number | Duplicated card number |
| 0079 | invalid.order.state | Invalid order state |
| 0080 | unauthorized.charge | Unauthorized charge |
| 0081 | invalid.time.interval | Invalid time interval |
| 0082 | forbidden.orders.for.company | It's not possible to create orders for companies |
| 0083 | forbidden.self.payment | It's not possible to make self-payments |
| 0084 | required.only.one.method | It's necessary inform only one payment method |
| 0085 | insufficient.transactional.limit | Customer with insufficient transactional limit |
| 0086 | forbidden.order.value.update | This order cannot has its value updated |
| 0087 | require.order.value.update | It's necessary update the order value |
| 0088 | invalid.2fa.code | Invalid 2FA code |
| 0089 | invalid.iso.datetime.format | Invalid datetime ISO-8601 format |
| 0090 | invalid.pix.qr_code | Invalid Pix Qr Code |
| 0091 | insufficient.daily.transactional.limit | Customer with insufficient daily transactional limit |
| 0092 | insufficient.monthly.transactional.limit | Customer with insufficient monthly transactional limit |
| 0093 | compliance.issues | Customer is not able to create orders due to compliance issues |
| 0094 | operational.limit.error.code | bad.request.value.exceeds.operational.limit |
| 0095 | invalid.account.number | Invalid account number |
| 0096 | invalid.account.type | Invalid account type |
| 0097 | invalid.quotation.state | Invalid quotation state |
| 0098 | invalid.zip.code | The informed zip code is invalid. |
| 0099 | payment.type.possible.values.generic | The only possible values are BANK_SLIP, TRANSFER, PICPAY, PIX, TED, CASH, EFT and OPEN_FINANCE |
| 0100 | bad.request.user.blocked | User is blocked by exceeded transaction limit and/or in risk analysis process. We need additional documentation (income tax + receipt) to increase or release the transaction limit. |
| 0101 | bad.request.user.refused | User was refused in the compliance & risk analysis process, unable to generate payment order. |
| 0102 | bad.request.user.closed | User account is closed, unable to generate payment order. |
| 0103 | bad.request.user.in.analysis | The user is in the process of analysis by the compliance and risk analysis team, it is not possible to generate the order until it is approved. |