Códigos de Erro

Sobre os códigos de Erro EBANX.

Saiba mais sobre os códigos de erro e o que eles significam.

Esta página contém códigos e descrições de todos os erros que podem ocorrer quando você se comunica com o nosso sistema.

Caso você ainda tenha dúvidas sobre como interpretar um erro específico, entre em contato com a Equipe de Suporte.

Sempre que uma requisição à nossa API falhar, o EBANX retornará um objeto JSON com os detalhes do erro, como no exemplo abaixo, assim você não perde seu tempo (ou dinheiro) tentando identificar problemas:

{

"status": "ERROR",

"status_code": "BP-SA-1",

"status_message": "Parameter integration_key not informed"

}

Dessa forma, você identifica onde está o erro e pode corrigi-lo rapidamente. Confira a tabela a seguir e verifique os possíveis “status_code”, além das mensagens de erro (“status_message”) que o EBANX utiliza e uma breve descrição das mesmas.

Observe os links a seguir para a Integração com EBANX Direct API e Payment Page EBANX.

códigos de Erro API

Erros relacionados a pagamentos

Error codes, messages and descriptions

search

Código arrow_downward	Mensagem de erro arrow_downward	Descrição arrow_downward
BP-CH-1	Payment type group is not active: {group_code}	Algum método de pagamento não está habilitado. Entre em contato com nossa Equipe de Integração.
BP-DR-0	Payment already exists with merchant_payment_code: X (created on X, status is X)	Apenas um pagamento com o mesmo merchant_payment_code poderá existir no sistema.
BP-DR-2	Field payment is required	O campo não foi preenchido.
BP-DR-3	Field payment.currency_code is required	O campo não foi preenchido.
BP-DR-5	Field payment.amount_total is required	O campo não foi preenchido.
BP-DR-6	Amount reported is less than the minimum amount	O valor do pagamento é inferior ao montante mínimo
BP-DR-7	Amount must be less than X	O valor do pagamento é muito alto.
BP-DR-8	If passed, amount_itens + amount_shipping must be equal to amount_total	O valor informado está incorreto
BP-DR-9	Field payment.merchant_payment_code is required	O campo não foi preenchido.
BP-DR-10	Parameter merchant_payment_code can have 40 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-DR-11	Parameter payment.order_number can have 40 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-DR-12	Parameter X can have 20 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-DR-35	Invalid payment_type_code: X	O método de pagamento informado não está habilitado. Entre em contato com nossa Equipe de Integração.
BP-DR-36	Payment type is not active	O método de pagamento informado não está habilitado. Entre em contato com nossa Equipe de Integração.
BP-DR-38	Payment type not allowed in Direct API (full mode): X	Alguns tipos de pagamento não são permitidos no modo 'full', consulte a documentação.
BP-DR-41	Field payment.person_type must contain a valid person_type	O parâmetro enviado é inválido.
BP-DR-47	Parameter payment.directdebit.bank_account can have 10 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-DR-50	Payment type not allowed in Direct API (full mode): {payment_type_code}	Este método de pagamento não é permitido. Entre em contato com nossa Equipe de Integração.
BP-DR-57	Parameter is in an invalid format: due_date. Correct Format: dd/MM/yyyy	O parâmetro enviado não está formatado corretamente.
BP-DR-58	Parameter is invalid: due_date – exceeds more than {days} days	O parâmetro 'due_date' enviado excedeu o número de dias configurados.
BP-DR-59	Parameter is invalid: due_date – less than permitted	O parâmetro ‘due_date’ enviado é inferior ao permitido.
BP-DR-68	Field payment.directdebit.bank_account is required	O campo não foi preenchido.
BP-DR-69	Parameter payment.directdebit.bank_agency can have 10 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-DR-70	Field payment.directdebit.bank_agency is required	O campo não foi preenchido.
BP-DR-71	Parameter payment.directdebit.bank_code can have 5 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-DR-72	Field payment.directdebit.bank_code is required	O campo não foi preenchido.
BP-DR-73	Field payment.directdebit is required for this payment type	O campo não foi preenchido.
BP-DR-77	Country is not enabled	O país informado não está disponível em sua conta. Entre em contato com nossa Equipe de Integração.
BP-DR-78	Country not enabled for merchant	O país informado não está disponível em sua conta. Entre em contato com nossa Equipe de Integração.
BP-DR-80	It was not possible to generate CIP. Please try again.	Ocorreu um erro na transação, por favor, tente novamente.
BP-DR-81	Currency code {currency_code} not allowed for payment type code: {payment_type_code}.	A moeda informada não pode ser usada para este método de pagamento.
BP-DR-82	Parameter payment.note can have 200 characters maximum.	O parâmetro 'nota' deve ter 200 caracteres ou menos.
BP-DR-84	Duplicate payment for the same customer and amount within {minutes} minutes.	Transação bloqueada para evitar que o cliente seja cobrado duas vezes.
BP-DR-85	Field payment.sub_account is required.	O campo não foi preenchido.
BP-DR-86	Parameter is invalid: payment.sub_account.	O parâmetro enviado é inválido.
BP-DR-87	Field payment.sub_account.name is required.	O campo não foi preenchido.
BP-DR-88	Field payment.sub_account.image_url is required.	O campo não foi preenchido.
BP-DR-91	Field payment.institution_code is required.	O campo não foi preenchido.
BP-DR-92	Field payment.institution_code is not a valid bank code.	O parâmetro enviado é inválido.
BP-DR-93	Error creating this payment within PSE ACH. Error code: ?.	Ocorreu um erro durante operação de pagamento.
BP-DR-99	Field payment.sub_account.image_url must be https	A URL da imagem enviada deve ser https.
BP-DR-102	Too many attempts	O cliente tentou realizar várias vezes a mesma transação em um curto período.
BP-DR-105	Missing Parameter for Flow method	O parâmetro payment.flow_payment_method é mandatório.
BP-DR-118	Invalid Sub Account data	A subconta enviada na solicitação é inválida.
BP-DR-130	For 3DS 2.0 transactions, field payment.card.threeds_cryptogram is required	O campo 'Cryptogram' não foi preenchido
BP-DR-131	For 3DS 2.0 transactions, field payment.card.threeds_eci is required	O campo 'ECI' não foi preenchido.
BP-DR-132	For 3DS 2.0 transactions, field payment.card.threeds_cryptogram and payment.card.threeds_eci are required	Os campos 'Cryptogram' e 'ECI'não foram preenchidos
BP-DR-141	Field payment.document_country must be a valid country	O país informado é inválido.
BP-REF-1	Parameter hash not informed	O campo não foi preenchido.
BP-REF-2	Payment not found for merchant, hash: X	O pagamento não foi encontrado. Entre em contato com nossa Equipe de Integração.
BP-REF-3	Parameter operation not informed (must be request or cancel)	O campo não foi preenchido.
BP-REF-4	Parameter amount not informed	O campo não foi preenchido.
BP-REF-5	Refund amount must be positive	Você está tentando realizar um reembolso com valor negativo.
BP-REF-6	Refund amount is greater than payment amount: X and X	Os valores do reembolso e do pagamento não coincidem.
BP-REF-7	Payment status is not CO, cannot be refunded: X	O status do pagamento não é 'CO' (confirmado), portanto, não pode ser reembolsado.
BP-REF-8	Payment has chargebacks, cannot be refunded: X	O pagamento contém estornos, portanto, não pode ser reembolsado.
BP-REF-9	Pending refund amount for payment would be greater than payment amount: X	Os valores do reembolso e do pagamento não coincidem.
BP-REF-10	Parameter description not informed	O campo não foi preenchido.
BP-REF-11	Parameters not informed: refund_id or merchant_refund_code	Verifique o refund_id nos parâmetros de resposta do reembolso criado ou através da 'query operation'. 'merchant_refund_code' é gerado opcionalmente pelo comerciante e também pode ser usado para identificar um reembolso.
BP-REF-12	Refund not found with id = X and merchant_refund_code = Y	Veja acima
BP-REF-13	Refund is already cancelled	O reembolso já foi cancelado
BP-REF-14	Refund is already confirmed	O Reembolso já foi confirmado
BP-REF-15	Invalid operation: X	Você está tentando realizar uma operação inválida.
BP-REF-16	Parameter merchant_refund_code can have 20 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-REF-17	A refund already exists with this merchant_refund_code: X	Já existe um reembolso com esse 'merchant_refund_code'.
BP-REF-18	Insufficient balance to create new refund. please contact finance@ebanx.com	Saldo insuficiente.
BP-REF-19	Credit card payment’s open date is older than 85 days ago.	O pagamento superou a data limite.
BP-REF-20	Request cannot contain both payment.card and payment.creditcard entries.	Apenas um parâmetro deve ser usado: payment.creditcard ou payment.card.
BP-REF-21	Invalid Transaction.	O documento do cliente foi bloqueado pelo Compliance.
BP-CAN-1	Parameter hash not informed	O campo não foi preenchido.
BP-CAN-2	Payment not found for merchant	Não foi encontrado o pagamento para este comerciante. Por favor, verifique as informações definidas.
BP-CAN-3	Payment is already cancelled	O pagamento já foi cancelado.
BP-CAN-4	Payment cannot be cancelled	O pagamento não pode ser cancelado.
BP-US-1	Parameter hash not informed	O campo não foi preenchido.
BP-US-2	Payment not found for merchant, hash: X	Não foi encontrado o pagamento para este comerciante. Por favor, verifique as informações definidas.
BP-US-3	Parameter status not informed	O campo não foi preenchido.
BP-US-4	Status must be either CO or CA	O status deve ser 'CO' ou 'CA'
BP-US-5	Operation NOT allowed in production mode	A operação 'updateStatus' só pode ser usada no ambiente de teste. No modo produção, as alterações de status são realizadas exclusivamente pelo sistema EBANX.
BP-Q-1	Parameters hash or merchant_payment_code not informed	O campo não foi preenchido.
BP-Q-2	Payment not found for merchant	Não foi encontrado o pagamento para este comerciante. Por favor, verifique as informações definidas.
BP-CAP-1	Parameters hash or merchant_payment_code not informed	O campo não foi preenchido.
BP-CAP-2	Payment not found for merchant	Não foi encontrado o pagamento para este comerciante. Por favor, verifique as informações definidas.
BP-CAP-3	Payment cannot be captured, status is: CA	O pagamento não pode ser capturado, verifique o status.
BP-CAP-4	Payment has already been captured, status is: CO	O pagamento já foi capturado.
BP-CAP-5	Payment cannot be captured, status is: OP	O pagamento não pode ser capturado, verifique o status.
BP-CAP-6	Payment cannot be captured, payment_type_code is:	O pagamento não pode ser capturado, verifique o status.
BP-CAP-7	Payment cannot be captured, auto_capture is: true	O pagamento não pode ser capturado, verifique o status.
BP-CAP-8	Payment cannot be captured, capture_available is: false	O pagamento não pode ser capturado, verifique o status.
BP-CAP-9	Payment cannot be captured, pre_approved is: false	O pagamento não pode ser capturado, verifique o status.
BP-CAP-10	Invalid amount	O valor informado é inválido.
BP-CAP-11	Partial capture not available	Captura parcial não disponível.
BP-CAP-12	Payment cannot be captured, amount must be equal or less than {currency_code} {max_amount}	O valor do pagamento excede o limite.
BP-REF-CAN-1	Payment can not be cancelled and can not generate a refund. Payment status is CA	O pagamento não pode ser cancelado e um reembolso não pode ser gerado, verifique o status.
BP-DMO-1	Payment not found for merchant: merchant_payment_code={merchant_payment_code}	Não foi encontrado o pagamento para este comerciante. Por favor, verifique as informações definidas.
BP-DMO-2	Only payments with status OP can be modified (your payment status is {status})	Apenas pagamentos com status OP podem ser modificados.
BP-DOC-01	Invalid document: {document}	Documento inválido
BP-DOC-02	Invalid currency code: ADS, expected any of USD, BRL, EUR, MXN, PEN.	A moeda enviada na requisição é inválida.
BP-ZIP-1	Zipcode code not informed	O campo não foi preenchido.
BP-ZIP-2	Zipcode is not valid	O parâmetro enviado é inválido.
BP-ZIP-3	The address could not be retrieved	Não foi possível encontrar o endereço informado.
BP-DR-111	Could not validate document. Please try again	Não foi possível validar o documento

Erros relacionados ao cartão

Error codes, messages and descriptions

search

Código arrow_downward	Mensagem de erro arrow_downward	Descrição arrow_downward
BP-DR-33	Invalid value for instalments: X (single value)	O parâmetro enviado é inválido.
BP-DR-34	Invalid value for instalments: X (range)	O parâmetro enviado é inválido.
BP-DR-48	Field payment.creditcard is required for this payment type	O campo não foi preenchido.
BP-DR-49	Field payment.creditcard.card_number is required	O campo não foi preenchido.
BP-DR-51	Field payment.creditcard.card_name is required	O campo não foi preenchido.
BP-DR-54	Field payment.creditcard.card_cvv is required	O campo não foi preenchido.
BP-DR-55	Parameter payment.creditcard.card_cvv can have 4 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-DR-56	Field payment.creditcard.card_due_date is required	O campo não foi preenchido.
BP-DR-57	Parameter is in an invalid format: due_date. Correct Format: dd/MM/yyyy	O parâmetro enviado não está formatado corretamente.
BP-DR-61	It was not possible to create the token for this credit card	Não foi possível concluir a operação. Veja mais detalhes na nossa documentação.
BP-DR-62	Recurring payments are not enabled for this merchant	O pagamento recorrente não está para sua conta. Entre em contato com nossa Equipe de Integração.
BP-DR-63	Token not found for this acquirer	Não foi encontrado o token para este adquirente. Verifique as informações contidas em sua requisição.
BP-DR-64	Token not found	O token não foi encontrado. Verifique se as informações estão corretas.
BP-DR-65	The provided token is already in use	O token que você está tentando criar já existe.
BP-DR-66	Token not valid. The token length must be between 32 and 128 characters	O parâmetro contém mais caracteres que o limite permitido.
BP-DR-67	Field payment.creditcard.card_due_date is invalid	O parâmetro enviado é inválido.
BP-DR-75	Card number is invalid	O parâmetro enviado é inválido.
BP-DR-79	The amount of instalments is larger than the maximum allowed for merchant	O número de parcelas que foi informado não é permitido. Entre em contato com nossa Equipe de Integração.
BP-DR-83	Foreign credit card cannot be processed.	O cartão de crédito foi emitido em um país diferente ao país do adquirente.
BP-DR-89	The amount of instalments is not allowed – blocked values are: {payment.api.instalments.blocked}	O número de parcelas que foi informado não é permitido. Entre em contato com nossa Equipe de Integração.
BP-DR-94	The token’s credit card has expired	O token que foi informado expirou.
BP-DR-95	Parameter payment.card.card_name must be a valid name: number isn’t allowed	O cliente pode ter confundido os campos e colocado o número do cartão no lugar do nome.
BP-DR-96	Token expired	O token expirou.
BP-DR-97	Instalment payments are not allowed for prepaid cards.	Não são permitidos pagamentos parcelados para cartões pré-pagos.
BP-DR-100	Instalment payments are not allowed for debit cards	Não são permitidos pagamentos parcelados para cartões de débito.
BP-DR-101	Card is not eligible for ecommerce	O cartão fornecido pelo cliente não pode ser usado para transações online
BP-DR-112	Too many attempts resulting in Insufficient Funds for this card	O cliente atingiu o limite de tentativas do cartão devido a saldo insuficiente (2 tentativas).
BP-DR-113	Invalid transaction	O documento do cliente foi bloqueado pelo Compliance.
BP-DR-117	Value per instalment cannot be lower than R$5.00	O valor mínimo por parcela é de 5 BRL, independente do número de parcelas.
BP-DR-129	Payments with instalments must be made with auto-capture mode enabled.	Para pagamentos parcelados, a função 'auto-capture' deve estar habilitada.
BP-DR-133	Parameters payment.card.threeds_cryptogram and payment.card.threeds_eci are required	Os campos não foram preenchidos.

Erros relacionados ao cliente

Error codes, messages and descriptions

search

Código arrow_downward	Mensagem de erro arrow_downward	Descrição arrow_downward
BP-DR-13	Field payment.name is required	O campo não foi preenchido.
BP-DR-14	Parameter payment.name can have 100 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-DR-15	Field payment.email is required	O campo não foi preenchido.
BP-DR-16	Parameter payment.email can have 100 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-DR-17	Field payment.email must be a valid email	O e-mail informado é inválido
BP-DR-18	Customer is disabled on EBANX	O cliente está bloqueado no EBANX. Caso pareça um engano, entre em contato com a equipe de suporte EBANX.
BP-DR-19	Field payment.birth_date is required	O campo não foi preenchido.
BP-DR-20	Field payment.birth_date must be a valid birth date (dd/MM/yyyy)	A data de nascimento informada é inválida.
BP-DR-21	Customer must be at least 16 years old	O cliente não tem a idade mínima exigida.
BP-DR-22	Field payment.document is required	O campo não foi preenchido.
BP-DR-23	Field payment.document must be a valid {document}	Lista de documentos por Pais: Brasil: CPF Argentina: DNI, CUIT, CUIL and CDI. Chile: RUT Colombia: CC, CE and NIT.
BP-DR-24	Field payment.zipcode is required	O CEP (Código de Endereçamento Postal) não foi informado.
BP-DR-25	Field payment.address is required	O campo não foi preenchido.
BP-DR-26	Field payment.street_number is required	O campo não foi preenchido.
BP-DR-27	Field payment.city is required	O campo não foi preenchido.
BP-DR-28	Field payment.state is required	O campo não foi preenchido.
BP-DR-29	Field payment.state must be a valid state code	Consulte o link para conferir a lista de códigos dos estados brasileiros: http://en.wikipedia.org/wiki/States_of_Brazil
BP-DR-31	Field payment.phone_number is required	O campo não foi preenchido.
BP-DR-32	Parameter payment.phone_number must be a valid phone number	O parâmetro enviado é inválido.
BP-DR-39	CPF, name, and birth date do not match: X	O EBANX verifica se o nome, CPF e data de nascimento informados pelo cliente coincidem com os dados da Receita Federal.
BP-DR-40	This payment exceeds the maximum amount per month. Customer current balance: X	Cliente atingiu o limite mensal de pagamento.
BP-DR-42	Field payment.responsible is required	O campo não foi preenchido.
BP-DR-43	Field payment.responsible.name is required	O campo não foi preenchido.
BP-DR-44	Field payment.responsible.document is required	O campo não foi preenchido.
BP-DR-45	Field payment.responsible.birth_date is required	O campo não foi preenchido.
BP-DR-46	Company responsible’s CPF, name, and birthdate do not match: (.*)	Os parâmetros informados são incompatíveis.
BP-DR-90	This customer is in our blacklist: {reason}.	O cliente está desabilitado em nosso sistema.
BP-DR-98	Customer e-mail is associated with payments for {customer.country}, not {payment.country}, please use another e-mail	O país do pagamento não corresponde ao país do cliente.
BP-DR-103	Customer disabled	O cliente foi desabilitado temporariamente (número excessivo de cartões de crédito).
BP-DR-140	Not authorized to foreign customer transactions	Não são autorizadas transações para clientes estrangeiros.

Erros gerais

Error codes, messages and descriptions

search

Código arrow_downward	Mensagem de erro arrow_downward	Descrição arrow_downward
BP-DR-1	Mode must be either full or iframe	Verifique as opções disponíveis em nossa documentação para o campo 'mode'.
BP-DR-4	Currency is not active in the system: X	A moeda informada não é suportada pelo sistema EBANX.
BP-DR-104	Invalid notification_url	A URL informada é inválida.
BP-DR-106	You have reached the limit of your processing trial. Make sure you send the documents to unlock this limit or send an email to your business manager.	Sua conta atingiu o limite de processamento. Para continuar operando você deve fazer o upload dos seus documentos (via Dashboard) ou falar com nossa Equipe Comercial.
BP-DR-108	Invalid FX Token.	O FX Token informado é inválido.
BP-DR-109	FX Token not enabled.	Fale com nossa Equipe Comercial para habilitar o Token FX.
BP-DR-110	FX Token: Base currency not enabled. FX Token: Target currency not enabled. FX Token: Currency not found.	A moeda informada é inválida
BP-DR-120	External service not available	Não foi possível estabelecer a conexão com o serviço externo.
BP-DPAR-1	Request_body is empty	Seu sistema está enviando o parâmetro 'request_body' vazio.
BP-DPAR-2	Invalid JSON expression	O objeto JSON enviado contém algum erro. Verifique se não há espaços em branco ou erros de digitação.
BP-DPAR-3	Field integration_key is required	O campo não foi preenchido.
BP-DPAR-4	Invalid integration key	A chave de integração informada é inválida. Verifique se há erros de digitação.
BP-DPAR-5	Merchant account is not active	A conta do merchant está desabilitada, entre em contato com a equipe de suporte EBANX.
BP-DPAR-6	This merchant account is restricted to testing (use your production account or request one)	A conta informada não está habilitada para o ambiente de produção.
BP-DPAR-7	This merchant account cannot be used for testing (use your test account or request one)	A conta informada não está habilitada para o ambiente de testes.
BP-EX-1	Currency code not informed	O código da moeda não foi preenchido.
BP-EX-2	Currency is not active in the system	A moeda informada está desabilitada.
DA-0	Unknown error	Erro desconhecido. Entre em contato com a Equipe de Integração.
DA-1	Empty operation parameter	O campo não foi preenchido.
DA-2	Unrecognized operation: {operation}	Operação inválida.
BP-SA-1	Parameter integration_key not informed	O campo não foi preenchido.
BP-SA-2	Invalid integration key	A chave de integração informada é inválida. Verifique se há erros de digitação.
BP-SA-3	Merchant account is not active	A conta do merchant está desabilitada, entre em contato com a equipe de suporte EBANX.
BP-SA-4	This merchant account is restricted to testing (use your production account or request one)	Entre em contato com a Equipe de Integração.
BP-SA-5	This merchant account cannot be used for testing (use your test account or request one)	Entre em contato com a Equipe de Integração.

códigos de Erro Payment page

Erros relacionados a pagamentos

Error codes, messages and descriptions

search

Código arrow_downward	Mensagem de erro arrow_downward	Descrição arrow_downward
BP-R-1	Parameter is required: currency_code	O campo não foi preenchido.
BP-R-2	Parameter is required: amount	O campo não foi preenchido.
BP-R-3	Parameter is required: merchant_payment_code	O campo não foi preenchido.
BP-R-6	Parameter payment_type_code not informed	O campo não foi preenchido.
BP-R-7	Payment type is not active	O tipo de pagamento informado está desabilitado na sua conta. Entre em contato com nossa Equipe de Integração.
BP-R-8	Invalid payment_type_code	O parâmetro enviado é inválido.
BP-R-9	Amount must be positive: X	O valor informado é negativo. Verifique sua requisição.
BP-R-10	Amount must be greater than X	O valor informado é inferior ao limite mínimo.
BP-R-11	Payment type does not support instalments	O pagamento informado não suporta parcelamentos. Por exemplo: boleto.
BP-R-14	Parameter merchant_payment_code can have 20 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-R-15	Parameter order_number can have 40 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-R-16	Parameter user_value_1 can have 20 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-R-16	Parameter user_value_2 can have 20 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-R-16	Parameter user_value_3 can have 20 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-R-16	Parameter user_value_4 can have 20 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-R-16	Parameter user_value_5 can have 20 characters maximum	O parâmetro contém mais caracteres que o limite permitido.
BP-R-17	Payment status is not OP (open): X	O pagamento informado não possui o status OP.
BP-R-18	Parameter is invalid: person_type	O parâmetro enviado é inválido.
BP-R-19	Checkout by CNPJ is not enabled	O checkout via CNPJ está desabilitado em sua conta. Entre em contato com nossa Equipe de Integração se desejar alterá-lo.
BP-R-20	Parameter is in an invalid format: due_date. Correct Format: dd/MM/yyyy	O parâmetro enviado é inválido.
BP-R-21	Parameter is invalid: due_date – exceeds more than X days	O parâmetro enviado é inválido.
BP-R-22	Parameter is invalid: due_date – less than permitted	O parâmetro enviado é inválido.
BP-R-24	Parameter is required: country	O campo não foi preenchido.
BP-R-25	Country is not enabled	O país informado para o pagamento está desabilitado. Entre em contato com nossa Equipe de Integração.
BP-R-26	Country is not enabled for merchant	O país informado para o pagamento está desabilitado em sua conta. Entre em contato com nossa Equipe de Integração.
BP-R-27	Payment type is not enabled for merchant	O tipo de pagamento informado está desabilitado. Entre em contato com nossa Equipe de Integração.
BP-R-32	Amount must be less than X	O valor informado é muito alto.

Erros relacionados ao cartão

Error codes, messages and descriptions

search

Código arrow_downward	Mensagem de erro arrow_downward	Descrição arrow_downward
XX-XX	This is not an error	This is something messed up by Marcus

Erros relacionados ao cliente

Error codes, messages and descriptions

search

Código arrow_downward	Mensagem de erro arrow_downward	Descrição arrow_downward
BP-R-4	Parameter is required: name	O campo não foi preenchido.
BP-R-5	Parameter is required: email	O campo não foi preenchido.

Erros gerais

Error codes, messages and descriptions

search

Código arrow_downward	Mensagem de erro arrow_downward	Descrição arrow_downward
BP-R-23	Currency is not active in the system: X	A moeda informada está desabilitada habilitada.
BP-R-31	Invalid notification_url	A URL informada é inválida.
BP-R-34	You have reached the limit of your processing trial. Make sure you send the documents to unlock this limit or send an email to your business manager.	Sua conta atingiu o limite de processamento. Para continuar operando você deve fazer o upload dos seus documentos (via Dashboard) ou falar com nossa Equipe Comercial.
BP-DR-120	External service not available	Não foi possível estabelecer a conexão com o serviço externo.
RP-1	Request body is empty	O parâmetro 'body' foi enviado vazio, verifique seu código
RP-2	Invalid JSON expression: too deep	Verifique o seu objeto JSON.
RP-3	Invalid JSON expression – invalid or malformed	Verifique o seu objeto JSON.
RP-4	Invalid JSON expression – unexpected control character found (likely encoding error)	Verifique o seu objeto JSON.
RP-5	Invalid JSON expression – syntax error	Verifique o seu objeto JSON.
RP-6	Invalid JSON expression – bad UTF-8 characters (likely encoding error)	Verifique o seu objeto JSON.
RP-7	Invalid JSON expression – unknown error	Verifique o seu objeto JSON.
RP-8	Field integration_key is required	O campo não foi preenchido.
RF-1	Payment already exists with payment_type_code	O sistema permite apenas um pagamento por 'merchant_payment_code'.

Entendendo transaction_status em transações com cartão de crédito

O status da transação será retornado na resposta dos métodos direct e query da API no parâmetro payment.transaction_status.

{

"payment": {

"transaction_status":

{

"acquirer": "EBANX",

"code": "NOK",

"description": "Not accepted"

}

}

}

caution

Recomendamos que esses códigos não sejam usados para confirmar um pagamento, apenas para melhorar a experiência do usuário em seu aplicativo.

Status	Descrição
Accepted	A transação foi aceita.
Not accepted	A transação não foi aprovada. Aconselhe o cliente a entrar em contato com o emissor do cartão de crédito.
Insufficient funds	O saldo insuficiente no momento da transação. Aconselhe o cliente a usar outro cartão.
Incorrect customer data	Os dados do cliente estão incorretos. Aconselhe o cliente a conferir os dados informados.
Expired card	O cartão de crédito expirou. Aconselhe o cliente a usar outro cartão.
Security code mismatch	O código de segurança do cartão está incorreto. Aconselhe o cliente a revisá-lo.
Invalid card or card type	Cartão inválido, inexistente ou bloqueado. Aconselhe o cliente a entrar em contato com o emissor do cartão de crédito.
Invalid card number	O número do cartão inválido. Aconselhe o cliente a revisar os dados do cartão de crédito.
3-D Secure required	3-D Secure está habilitado para cartão de débito. Aconselhe o cliente a usar outro cartão.
Timeout	A conexão expirou. Tente novamente mais tarde.
No response from acquirer	O adquirente não respondeu à requisição. Tente novamente mais tarde.
Acquirer response error	A resposta do adquirente contém um erro. Tente novamente mais tarde.
Broken communication	A conexão foi interrompida. Tente novamente mais tarde.
Communication mismatch	Falha na comunicação entre o EBANX e o adquirente. Tente novamente mais tarde.
Cannot fulfill transaction	Não foi possível realizar a transação ou a mesma já foi executada. Não tente novamente.
Cannot cancel transaction	Não foi possível cancelar a transação. Não tente novamente
Invalid due date	Data de vencimento inválida. Aconselhe o cliente a revisar os dados do cartão de crédito.
Inactive card	O cartão de crédito não está ativo. Tente novamente mais tarde.
Refunded	Foi identificado um problema com o cartão de crédito. Não tente novamente.
Unknown acquirer error	O adquirente encontrou um erro desconhecido. Tente novamente mais tarde.
High risk transaction	A transação foi recusada por apresentar alta probabilidade de ser fraudulenta.
Issuer does not support installments	O número de parcelas que foi selecionado não está disponível para este cartão.
Cannot process transaction at this moment	O adquirente não conseguiu processar a solicitação no momento. Tente novamente mais tarde.

Obtendo Ajuda

Nós esperamos que este artigo tenha sido esclarecedor, mas caso não tenhamos tirado suas dúvidas você tem as seguintes opções para continuar buscando respostas:

• Se você ainda não é nosso parceiro e deseja saber mais sobre nossos preços e condições, entre em contato com nossa equipe comercial.
• Caso você já seja nosso parceiro, entre em contato com nossa equipe de suporte em faleconosco@ebanxpay.com.