Códigos de erro

Um código de erro tem a forma [PREFIXO]_[CÓDIGO], em que:

[PREFIXO] define a camada aplicativa na qual ocorreu o erro
[CÓDIGO] é o código numérico do erro.

Há diferentes prefixos:

PREFIXO DESCRIÇÃO EXEMPLO DE ERRO
ACQ Erro na parte adquirente ACQ_001
AUTH Erro de autenticação AUTH_149
CLIENT Aplicativo JavaScript (no navegador do comprador) CLIENT_003
INT Erro de integração (por parte do vendedor) INT_007
PSP Erro na parte PSP PSP_001

Os erros são reenviados por meio de quatro configurações:

{
  "errorCode": "INT_015",
  "errorMessage": "invalid customer email",
  "detailedErrorCode": null,
  "detailedErrorMessage": "Invalid input value [name=customer.email, value=fake-email]"
}
CONFIGURAÇÃO TYPE DESCRIPTION
errorCode string Código de erro (no formato [PREFIXO]_[CÓDIGO])
errorMessage string Mensagem de erro
detailedErrorCode string Código de erro detalhado (ou nulo)
detailedErrorMessage string Mensagem detalhada (ou nula)

Novos códigos de erro poderão ser adicionados no futuro. Sua implementação deve obrigatoriamente levar esta possibilidade em conta.

Erros ACQ

Estes erros ocorrem na parte do adquirente do vendedor (banco).

ERROR CODE DEFINITION
ACQ_001 Pagamento recusado
ACQ_999 Erro técnico

O código de recusa de autorização do adquirente é enviado em detailedErrorCode. Estes códigos são retornados sem modificação. São específicos a cada adquirente.

Por exemplo, se um cartão VISA for recusado por razão de roubo, a estrutura de erro será:

{
  "errorCode": "ACQ_001",
  "errorMessage": "payment refused",
  "detailedErrorCode": "43",
  "detailedErrorMessage": "Stolen card"
}

Os códigos de erros detalhados (detailedErrorCode) mais frequentes são:

CONJUNTO DE ERROS DESCRIÇÃO
cartões CB, Visa e Mastercard (França) Códigos de retorno específicos da rede CB
cartões American Express Códigos enviados pelo adquirente da Amex Global

Erros AUTH

Os erros AUTH (“autenticação”) geralmente ocorrem devido a problemas nos servidores de autenticação (com 3D-Secure por exemplo).

ERROR CODE DEFINITION
AUTH_100 invalid ACS Signature
AUTH_101 technical error 3DS
AUTH_102 wrong Parameter 3DS
AUTH_103 3DS Disabled
AUTH_149 3DS operation timeout
AUTH_999 technical error

Erros CLIENT

Estes erros ocorrem no navegador do comprador. Ocorrem antes do envio dos dados de pagamento para nossos servidores. Isso inclui, por exemplo, erros de validação de dados do formulário processados localmente ou erros de integração do cliente JavaScript.

Para mais detalhes, consulte a documentação do cliente JavaScript

Erros INT

Os erros INT (“integração”) geralmente ocorrem devido a problemas de integração por parte do vendedor.

Código DEFINITION
INT_005 configuração manualValidation inválida
INT_006 configuração captureDelay ou expectedCaptureDate inválida
INT_009 configuração amount inválida
INT_010 configuração currency inválida
INT_012 configuração customer.language inválida
INT_013 configuração orderId inválida
INT_015 configuração customer.email inválida
INT_016 configuração customer.reference inválida
INT_017 configuração customer.billingDetails.title inválida
INT_019 configuração customer.billingDetails.address inválida
INT_020 configuração customer.billingDetails.zipCode inválida
INT_021 configuração customer.billingDetails.city inválida
INT_022 configuração customer.billingDetails.country inválida
INT_023 configuração customer.billingDetails.phoneNumber inválida
INT_030 configuração paymentMethodToken inválida
INT_031 configuração contrib inválida
INT_040 configuração pan inválida
INT_041 configuração expiryMonth inválida
INT_042 configuração expiryYear inválida
INT_043 configuração securityCode inválida
INT_050 configuração strongAuthentication inválida
INT_060 configuração paymentSource inválida
INT_062 configuração mid inválida
INT_064 configuração rrule inválida
INT_066 configuração initialAmount inválida
INT_068 configuração initialAmountNumber inválida
INT_069 configuração effectDate inválida
INT_077 configuração customer.shippingDetails.cellPhoneNumber inválida
INT_081 configuração customer.shippingDetails.address inválida
INT_082 configuração customer.shippingDetails.address2 inválida
INT_083 configuração customer.shippingDetails.city inválida
INT_084 configuração customer.shippingDetails.state inválida
INT_085 configuração customer.shippingDetails.zipCode inválida
INT_086 configuração customer.shippingDetails.country inválida
INT_087 configuração customer.shippingDetails.address2 inválida
INT_088 configuração customer.billingDetails.state inválida
INT_091 configuração metadata inválida
INT_092 configuração customer.billingDetails.category inválida
INT_093 configuração customer.shippingDetails.category inválida
INT_095 configuração customer.shippingDetails.shippingMethod inválida
INT_095 configuração customer.shippingDetails.shippingSpeed inválida
INT_096 configuração customer.shippingDetails.deliveryCompanyName inválida
INT_097 configuração cartItemInfo.productLabel inválida
INT_098 configuração cartItemInfo.productType inválida
INT_100 configuração cartItemInfo.productRef inválida
INT_101 configuração cartItemInfo.productQty inválida
INT_102 configuração cartItemInfo.productAmount inválida
INT_104 configuração customer.billingDetails.firstName inválida
INT_105 configuração customer.billingDetails.lastName inválida
INT_106 configuração customer.shippingDetails.firstName inválida
INT_107 configuração customer.shippingDetails.lastName inválida
INT_108 configuração customer.shoppingCart.taxAmount inválida
INT_109 configuração customer.shoppingCart.shippingAmount inválida
INT_110 configuração customer.shoppingCart.insuranceAmount inválida
INT_112 configuração customer.billingDetails.streetNumber inválida
INT_113 configuração customer.billingDetails.district inválida
INT_114 configuração customer.shippingDetails.streetNumber inválida
INT_115 configuração customer.shippingDetails.district inválida
INT_121 configuração customer.billingDetails.legalName inválida
INT_124 configuração customer.billingDetails.identityCode inválida
INT_125 configuração customer.shippingDetails.legalName inválida
INT_130 parâmetro acquirerTransientData inválido
INT_131 configuração overridePaymentCinematic inválida
INT_102 configuração cartItemInfo.productVat inválida
INT_873 Configuração acquirerTransientData inválida
INT_874 configuração paymentMethodType inválida
INT_875 Configuração formAction inválida
INT_876 configuração payload inválida
INT_877 configuração customer.shippingDetails.identityCode inválida
INT_878 configuração commission inválida
INT_880 initialAmount e initialAmountNumber precisam ser definidos
INT_883 configuração description inválida
INT_885 configuração formToken inválida
INT_886 configuração debitCreditSelector inválida
INT_887 configuração brand inválida
INT_892 configuração paymentMethodType inválida
INT_893 configuração firstInstallmentDelay inválida
INT_895 configuração installmentNumber inválida
INT_896 a configuração não é compatível com a assinatura
INT_897 configuração subscriptionId inválida
INT_898 Configuração comment inválida
INT_899 Configuração retry inválida
INT_900 A configuração não existe
INT_901 Web service não encontrado
INT_902 Uma das configurações enviadas para o Web service é inválida
INT_903 formToken não encontrado
INT_904 Chave pública
INT_905 Nome de usuário ou senha inválidos
INT_906 configuração formToken inválido
INT_910 a criação do token cartão não está ativada para esse meio de pagamento
INT_911 A chave pública não corresponde ao formToken
INT_912 A senha não corresponde à transação
INT_913 Autorizado exclusivamente para os vendedores PCI-DSS
INT_999 Erro técnico

Erros PSP

Os erros PSP (Payment Service Provider) ocorrem quando o PSP não pode processar a solicitação.

Código Mensagem
PSP_501 A transação não foi encontrada.
PSP_502 A transação não foi encontrada.
PSP_503 Esta ação não é autorizada para uma transação com este status {0}.
PSP_504 Esta transação não é autorizada neste contexto.
PSP_505 A transação já existe.
PSP_506 Valor de transação inválida.
PSP_507 Esta ação não é mais possível para uma transação criada nesta data.
PSP_508 A data de vencimento do cartão não permite esta ação.
PSP_509 CVV obrigatório para o cartão.
PSP_510 O valor do reembolso é superior ao valor inicial.
PSP_511 A soma dos reembolsos efetuados é superior ao valor inicial.
PSP_512 A duplicação de um crédito (reembolso) não é autorizada.
PSP_513 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_514 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_515 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_516 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_517 A configuração remota do contrato Aurore falhou.
PSP_518 A análise da resposta da Cetelem falhou.
PSP_519 Moeda desconhecida.
PSP_520 Tipo de cartão inválido.
PSP_521 Nenhum contrato encontrado para este pagamento. Altere os dados ou entre em contato com seu gerente em caso de repetição de falhas.
PSP_522 Loja não encontrada.
PSP_523 Contrato ambíguo.
PSP_524 Contrato inválido.
PSP_525 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_526 Número de cartão inválido
PSP_527 Número de cartão inválido.
PSP_528 Número de cartão inválido.
PSP_529 Número de cartão inválido.
PSP_530 Número de cartão inválido (Luhn)
PSP_531 Número de cartão inválido (comprimento)
PSP_532 Número de cartão inválido (não encontrado)
PSP_533 Número de cartão inválido (não encontrado)
PSP_534 Controle cartão com autorização sistemática falhou.
PSP_535 Controle e-Carte Bleue falhou.
PSP_536 A transação foi recusada pelo controle dos riscos.
PSP_537 Interrupção não gerenciada durante o pagamento.
PSP_538 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_539 A transação foi recusada pelo 3D Secure.
PSP_540 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_541 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_542 Um erro interno ocorreu durante a consulta do número de cartão.
PSP_543 Um erro interno ocorreu durante a consulta do número de cartão.
PSP_545 Moeda inválida para a modificação.
PSP_546 O valor está superior ao valor autorizado.
PSP_547 A data de apresentação desejada é posterior à data de validade da autorização.
PSP_548 A modificação requerida é inválida.
PSP_549 Definição do pagamento múltiplo inválido.
PSP_550 Loja desconhecida.
PSP_551 Taxa desconhecida.
PSP_552 O contrato acabou desde o {0}.
PSP_553 A loja {0} fechou desde o {1}.
PSP_554 Parâmetro recusado porque pode conter dados sensíveis {0}.
PSP_555 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_557 Erro na recuperação do token cartão.
PSP_558 O status do token cartão não é compatível com esta operação.
PSP_559 Erro na recuperação do token cartão.
PSP_560 Token cartão existente.
PSP_561 Token cartão inválido
PSP_562 A criação de um token cartão foi recusada.
PSP_563 A assinatura já existe.
PSP_564 Esta assinatura já foi cancelada.
PSP_565 Este assinatura não é válida.
PSP_566 A regra de recorrência é inválida.
PSP_567 Criação da assinatura recusada.
PSP_569 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_570 Código país inválido.
PSP_571 Configuração do serviço web inválido.
PSP_572 Autorização recusada pela Cofinoga.
PSP_573 Recusa da autorização de um euro (ou solicitação de informações na rede CB, se for compatível com o adquirente).
PSP_574 Configuração de pagamento inválida.
PSP_575 A PayPal recusou a operação.
PSP_577 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_578 Identificador de transação não definido.
PSP_579 Código de transação já utilizado.
PSP_580 O código de transação venceu.
PSP_581 Conteúdo do tema config inválido.
PSP_582 O reembolso não é autorizado.
PSP_583 Valor de transação fora dos valores permitidos.
PSP_585 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_587 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_597 Nenhuma opção de pagamento ativada para este contrato.
PSP_592 Um erro ocorreu durante o cálculo do canal de pagamento.
PSP_593 Um erro ocorreu durante o retorno do comprador para a página de conclusão de pagamento.
PSP_594 Um erro técnico ocorreu.
PSP_596 Um erro foi encontrado durante a captura desta transação.
PSP_597 Data de apresentação esta distante demais.
PSP_598 Data de transação inválida.
PSP_599 Um erro ocorreu durante o cálculo da origem do pagamento.
PSP_600 Falhar do controle do e-cartão comercial.
PSP_601 Recusado porque a primeira parcela foi recusada.
PSP_603 A sincronização do status da transação com o sistema externo falhou.
PSP_604 Um erro foi encontrado durante a captura desta transação.
PSP_605 Um erro de segurança foi encontrado durante o processo 3DS desta transação.
PSP_606 Moeda não adequada para este contrato e/ou esta loja.
PSP_607 O cartão associado ao token cartão não está mais válido.
PSP_608 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_609 Prazo de espera excedido durante o redirecionamento do comprador.
PSP_610 Cartão de pagamento não adequado para este contrato.
PSP_611 Refus des transactions sans transfert de responsabilité.
PSP_612 O cancelamento não é autorizado.
PSP_613 A duplicação não é autorizada.
PSP_615 O reembolso não é autorizado.
PSP_616 Pagamento manual não autorizado para este cartão.
PSP_618 Pagamento manual parcelado não autorizado para este cartão.
PSP_619 A data submetida é inválida.
PSP_620 A opção de pagamento da transação inicial não é aplicável.
PSP_624 Cartão inativo.
PSP_625 Pagamento recusado pelo adquirente.
PSP_626 Esta ação não é possível porque a sequência de pagamento não terminou.
PSP_636 Refus des transactions dérivées, sans transfert de responsabilité sur la transaction primaire.
PSP_637 A transação já existe.
PSP_638 Não é possível realizar o reembolso parcial para esta transação.
PSP_639 Reembolso recusado.
PSP_641 O analisador de riscos recusou esta transação.
PSP_642 O tipo de cartão usado é inválido com o modo de pagamento solicitado.
PSP_643 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_644 Uma transação em modo de produção foi marcada em modo de teste pelo adquirente.
PSP_645 Uma transação em modo de teste foi marcada em modo de produção pelo adquirente.
PSP_646 Código sms inválido.
PSP_647 O módulo de gestão de fraudes solicitou a recusa desta transação.
PSP_648 Devido a um problema técnico, não podemos responder a sua solicitação. A transação não foi criada.
PSP_649 O tempo limite da sessão de pagamento foi atingido (caso do comprador redirecionado para o ACS e que não conclui a autenticação 3D Secure).
PSP_650 Devido a um problema técnico, não podemos responder a sua solicitação. A transação não foi criada.
PSP_651 Uma transação Facily Pay não pode ser cancelada/modificada/reembolsada entre 23h30 e 5h30.
PSP_652 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_653 Ocorreu uma falha durante a chamada para o serviço Banque Accord.
PSP_655 Não foi possível cancelar/alterar/reembolsar a transação Facily Pay: o status da transação não permite realizar a ação solicitada. Lembrete sobre uma transação Facily Pay: um reembolso deve respeitar o prazo de dois dias após a remessa; o prazo entre dois reembolsos é de um dia, um reembolso parcial é limitado a 20 dias e um reembolso total é limitado a seis meses.
PSP_658 Devido a um problema técnico, não podemos responder a sua solicitação.
PSP_659 O valor é inferior ao valor mínimo autorizado (mínimo={0} {1}).
PSP_660 É impossível reembolsar um transação não paga.
PSP_665 O tipo de documento de identidade está presente, mas não consta seu número.
PSP_666 O número do documento de identidade está presente, mas não consta seu tipo.
PSP_667 O tipo de documento de identidade é desconhecido.
PSP_668 O número de documento de identidade é inválido.
PSP_669 Os dados específicos que devem ser enviados ao adquirente são inválidos.
PSP_670 O pagamento adiado não é autorizado.
PSP_671 O número de meses para o pagamento adiado não é autorizado.
PSP_672 A cinemática de pagamento selecionada é inválida.
PSP_673 Erro no serviço Express Checkout da PayPal.
PSP_675 Cancelamento impossível, favor tentar um reembolso.
PSP_676 Reembolso impossível, favor tentar um cancelamento.
PSP_677 Nenhuma resposta ao pedido de autorização foi recebida dentro do prazo.
PSP_678 Cancelamento impossível, a transação já foi cancelada.
PSP_679 O status da transação é desconhecido.
PSP_682 O CPF/CNPJ do cliente está ausente.
PSP_683 O formato do CPF/CNPJ do cliente está incorreto.
PSP_998 Erro de HTTP
PSP_999 Erro técnico