Códigos de recusa
Códigos de recusa da Checkout.com: o que cada código de resposta significa
Verificado em
A Checkout.com responde a cada pagamento com um `response_code` de cinco dígitos. Os códigos 20xxx são recusas leves que podem ser aprovadas mais tarde, os códigos 30xxx são recusas definitivas que exigem que o banco ou o titular do cartão resolvam algo primeiro, e os códigos 4xxxx são respostas de risco das suas próprias regras ou das da Checkout.com. Cada página abaixo fornece o significado simples, se a Visa permite uma nova tentativa, o que o comprador e a loja devem fazer, e como a PlatformDTC lida com o código quando uma loja conecta sua própria conta Checkout.com.
| Código de resposta | Significado |
|---|---|
| 20001 | O banco recusou e quer que o comprador o contate antes de aprovar. |
| 20002 | O banco recusou sob suas próprias condições especiais e encaminha o comprador de volta a ele. |
| 20003 | O pagamento falhou por uma razão técnica do lado do lojista ou adquirente, não por causa do cartão. |
| 20005 | O banco recusou sem dar um motivo. A recusa genérica mais comum. |
| 20012 | O banco diz que este tipo de transação não é permitido para o cartão. A Visa diz para nunca tentar novamente. |
| 20013 | O valor enviado com o pagamento era inválido para o banco ou para a rede. |
| 20014 | O número do cartão não existe no banco. Geralmente um erro de digitação. A Visa diz para nunca tentar novamente. |
| 20019 | O banco não conseguiu processar desta vez e pede que o pagamento seja enviado novamente. |
| 20030 | A mensagem de pagamento tinha um formato que a rede ou o banco não conseguia ler. |
| 20046 | O banco recusou o pagamento. Assim como 'do not honour', nenhuma razão é dada. |
| 20051 | O cartão não tem saldo disponível ou crédito suficiente para este valor. |
| 20054 | A data de validade do cartão expirou. Apenas um novo cartão ou uma data atualizada pode funcionar. |
| 20057 | O cartão não tem permissão para fazer este tipo de pagamento. A Visa diz para nunca retentá-lo. |
| 20059 | O banco suspeita que o pagamento é fraudulento e o recusou. |
| 20061 | O limite de gastos do cartão para um período foi atingido. |
| 20062 | O banco restringiu o cartão, por exemplo, para certos países ou usos. |
| 20063 | O banco recusou por um motivo de segurança ligado aos detalhes do cartão ou autenticação. |
| 20064 | O valor não correspondeu ao que o banco esperava para a transação original. |
| 20065 | O cartão fez muitos pagamentos em pouco tempo e atingiu seu limite de frequência. |
| 20068 | O banco não respondeu a tempo, então o pagamento falhou. |
| 20075 | O cartão está bloqueado após muitas tentativas de PIN incorretas. |
| 20078 | Um cartão novo ou de substituição ainda não foi ativado. |
| 20082 | Os dados de segurança do cartão falharam nas verificações do banco. |
| 20087 | O código de segurança ou a data de validade inseridos estão errados. |
| 20091 | O banco do comprador não pôde ser contatado, portanto, não pôde aprovar o pagamento. |
| 20093 | O banco recusou porque o pagamento violaria uma lei ou regulamento que ele aplica. |
| 20096 | Um erro de sistema interrompeu o pagamento. Não é o cartão do comprador. |
| 20099 | O banco retornou uma resposta que a Checkout.com não conseguiu mapear para um código conhecido. |
| 2005C | O banco bloqueia este tipo de transação no cartão. |
| 2009G | O titular do cartão bloqueou pagamentos como este em seu próprio cartão. |
| 200N7 | O código de segurança (CVV) inserido não corresponde ao cartão. |
| 200P1 | O cartão atingiu seu limite diário de gastos. |
| 200P9 | O valor está acima de um limite no cartão; um valor menor poderia passar. |
| 200R1 | O titular do cartão cancelou este pagamento recorrente com seu banco. |
| 200R3 | O titular do cartão cancelou todos os pagamentos recorrentes para este lojista no cartão. |
| 20100 | A data de validade foi enviada em um formato que a rede não pôde aceitar. |
| 20102 | Um identificador de lojista ou carteira no pagamento não era válido. |
| 20103 | Este tipo de cartão ou método de pagamento não é suportado para o pagamento. |
| 20104 | O gateway do Checkout.com rejeitou a transação como inválida. |
| 20105 | O gateway da Checkout.com rejeitou o pagamento por quebrar uma regra. |
| 20108 | O banco tem detalhes de cartão mais recentes para este cliente. O cartão antigo não funcionará. |
| 20112 | A conta da loja não está configurada para o 3-D Secure da Mastercard. |
| 20150 | O cartão não está cadastrado no 3-D Secure, portanto, a etapa de autenticação não pôde ser executada. |
| 20151 | O comprador não passou na etapa de verificação do banco. |
| 20152 | A etapa de verificação do banco foi deixada incompleta por 15 minutos e expirou. |
| 20153 | Uma falha no sistema 3-D Secure interrompeu o pagamento. |
| 20154 | O banco exige verificação 3-D Secure antes de aprovar. |
| 20157 | A configuração da Checkout.com da loja é inválida para este pagamento. |
| 20159 | O servidor de autenticação do banco falhou durante o 3-D Secure. |
| 20179 | Os dados do cartão não são mais válidos, por exemplo, um cartão desatualizado. |
| 20182 | O pagamento não está em conformidade com as políticas do cartão. |
| 20183 | O pagamento é suspeito de ser fraudulento. |
| 30004 | O banco quer que o cartão seja retirado de uso, sem dizer que é fraude. Nunca tente novamente. |
| 30007 | O banco retirou o cartão sob condições especiais. Nunca tente novamente. |
| 30015 | O número do cartão não pertence a nenhum banco conhecido. Geralmente um erro de digitação. |
| 30020 | O valor do pagamento não era válido. |
| 30021 | O cartão atingiu seu limite total de gastos. |
| 30022 | O cartão atingiu seu limite no número de transações. |
| 30033 | O cartão está vencido e o banco quer que ele seja retirado de uso. |
| 30034 | O banco suspeita de fraude e quer que o cartão seja retirado. Nunca tente novamente. |
| 30035 | O banco recolheu o cartão e encaminha o lojista ao seu adquirente. |
| 30036 | O cartão está restrito e o banco quer que ele seja recolhido. |
| 30037 | O banco retirou o cartão e pede para a equipe de segurança da adquirente ligar. |
| 30041 | O cartão foi reportado como perdido. Nunca tente novamente. |
| 30043 | O cartão foi reportado como roubado. Nunca tente novamente e tenha cuidado com o pedido. |
| 30044 | Um cartão pré-pago anônimo não pode pagar mais de 50 EUR sob as regras anti-lavagem de dinheiro da UE. |
| 30046 | A conta do cartão está fechada. Nunca tente novamente. |
| 41101 | Bloqueado por uma das suas próprias regras de risco em nível de cliente na Checkout.com. |
| 41201 | O número do cartão está na sua lista de recusa em nível de cliente. |
| 41202 | O intervalo bancário do cartão (BIN) está na sua lista de recusa em nível de cliente. |
| 41203 | O endereço de e-mail do comprador está na sua lista de recusa em nível de cliente. |
| 41204 | O número de telefone do comprador está na sua lista de recusa em nível de cliente. |
| 41205 | O endereço IP do comprador está na sua lista de recusa em nível de cliente. |
| 41206 | O domínio do e-mail está na sua lista de recusa em nível de cliente. |
| 41301 | A pontuação de fraude do pagamento estava acima do limite que você definiu. |
| 42101 | Bloqueado por uma regra de risco de nível de entidade na Checkout.com. |
| 42201 | O número do cartão está em uma lista de recusa de nível de entidade. |
| 42301 | A pontuação de fraude estava acima de um limite de nível de entidade. |
| 43101 | A própria Checkout.com recusou o pagamento por alto risco. |
| 43102 | Bloqueado por uma regra de recusa ou modelo de fraude da Checkout.com, nomeado no resumo. |
| 43201 | O cartão está na própria lista de recusa da Checkout.com. |
| 43202 | O BIN do cartão está na própria lista de recusa da Checkout.com. |
| 43205 | O IP do comprador está na própria lista de recusa da Checkout.com. |
| 43301 | O Autopilot da Checkout.com recusou o pagamento devido a uma pontuação de fraude alta. |
| 43401 | A Checkout.com exige autenticação 3-D Secure antes que este pagamento possa ser processado. |
Como funcionam as novas tentativas na Checkout.com
A Visa classifica as recusas em quatro categorias. A Categoria 1 (o emissor nunca aprovará) não deve ser tentada novamente. As Categorias 2, 3 e 4 permitem no máximo 15 novas tentativas em 30 dias, e a Visa cobra taxas além disso. A Checkout.com associa cada categoria a um código de recomendação: 03 não tentar novamente, 02 tentar novamente mais tarde, 01 informações atualizadas ou adicionais necessárias.
Para Mastercard, a Checkout.com retorna o código de aconselhamento do comerciante em `processing.partner_merchant_advice_code`. Os códigos 03 e 21 significam não tentar novamente; 24 a 30 indicam uma espera de uma hora a 10 dias após uma recusa por fundos insuficientes.
Checkout.com na PlatformDTC
Uma loja PlatformDTC pode conectar sua própria conta Checkout.com e aceitar pagamentos com cartão através do Checkout.com Flow, incluindo renovações de assinatura cobradas no cartão armazenado.
Quando um pagamento é recusado, a PlatformDTC lê o `response_code` e o classifica em redirecionar, tentar mais tarde, precisa de 3-D Secure, nunca tentar novamente ou parar por fraude. Apenas os códigos de redirecionamento podem acionar o backup da loja, os campos de cartão PayPal, e somente se a loja o escolheu. Pagamentos de renovação que a Checkout.com relata como Pendente ou Nova Tentativa Agendada não são tratados como recusas. As renovações de assinatura na Checkout.com usam as mesmas classes de recusa que as renovações da Stripe: fundos baixos (20051) seguem o cronograma de pagamento, "não honrar" e recusas bancárias (20005, 20046) recebem mais uma tentativa, erros temporários são tentados novamente por 8 dias, e cartões expirados, perdidos, roubados, fechados ou restritos, cada recusa definitiva 30xxx e cada resposta de risco 4xxxx param imediatamente e pedem ao cliente um novo cartão.
Listas de recusa semelhantes existem no nível da entidade e da Checkout.com para cada campo (42202 a 42206, 43203, 43204, 43206); esta biblioteca cobre os distintos e explica os níveis em cada página.
Perguntas frequentes
- Qual a diferença entre os códigos 20xxx e 30xxx da Checkout.com?
- A Checkout.com diz que 20xxx são recusas leves onde tentativas posteriores podem ter sucesso, e 30xxx são recusas definitivas onde a maioria precisa que o emissor ou o titular do cartão resolvam algo antes de uma nova tentativa.
- Os códigos 4xxxx vêm do banco?
- Não. São respostas de risco das suas regras de Detecção de Fraude ou das próprias verificações da Checkout.com, decididas antes de o banco ser consultado.
Fontes
- Códigos de resposta da API — Checkout.com
- Códigos de resposta da Visa — Checkout.com
- Códigos de recomendação — Checkout.com
- Mapeamento para as categorias de taxa de integridade do sistema Visa — Adyen