Códigos de recusa
Motivos de recusa da Adyen explicados
Verificado em
Quando a Adyen não consegue concluir um pagamento, ela retorna um `resultCode` (Refused, Error ou Cancelled) com um `refusalReason` e um `refusalReasonCode` numérico. Alguns motivos são o banco do comprador recusando, alguns são triagem de fraude, alguns são problemas de 3D Secure, e alguns são cancelamentos. Cada página explica um motivo de recusa em palavras simples, se uma nova tentativa é permitida sob as regras do esquema de cartão, e como a PlatformDTC lida com a recusa correspondente.
| Código de recusa | Significado |
|---|---|
| 2 | O emissor recusou o pagamento e não deu nenhum motivo utilizável; a recusa genérica da Adyen. |
| 3 | O emissor encaminhou o pagamento: ele quer que o titular do cartão (ou lojista) o contate primeiro. |
| 4 | Algo falhou do lado do adquirente, não com o cartão do comprador. |
| 5 | O cartão está bloqueado e não pode ser usado. |
| 6 | A data de validade do cartão expirou. |
| 7 | Ocorreu uma inconsistência de valor durante o processamento do pagamento. |
| 8 | O número do cartão está errado ou não existe. |
| 9 | A Adyen não conseguiu contatar o banco do comprador para autorizar o pagamento. |
| 10 | O banco do comprador não suporta ou não permite este tipo de transação no cartão. |
| 11 | A autenticação 3D Secure não foi realizada ou não teve sucesso. |
| 12 | O cartão não tem dinheiro ou crédito suficiente para este valor. |
| 14 | O adquirente sinalizou o pagamento como possível fraude. |
| 15 | A transação foi cancelada antes de ser concluída. |
| 16 | O comprador cancelou o pagamento antes de concluí-lo. |
| 20 | As verificações de risco de pré-autorização da Adyen pontuaram o pagamento em 100 ou mais e o recusaram. |
| 21 | A transação não foi enviada corretamente para processamento. |
| 22 | As verificações de risco de pré e pós-autorização juntas pontuaram 100 ou mais, então o pagamento foi recusado. |
| 23 | O emissor ou adquirente não permite esta transação neste cartão (raw 57 ou 58). |
| 24 | O código de segurança do cartão (CVC) inserido está errado. |
| 25 | O emissor restringiu onde este cartão pode ser usado (raw 62). |
| 26 | O comprador pediu ao seu banco para parar esta assinatura ou todos os pagamentos recorrentes (raw R0, R1, R3). |
| 27 | Uma recusa específica que a Adyen não conseguiu mapear de forma confiável para um de seus motivos nomeados. |
| 28 | O valor está acima do limite de gastos permitido no cartão (bruto 61). |
| 29 | O cartão foi usado mais vezes do que o emissor permite no período (bruto 65). |
| 31 | O banco do comprador relatou o pagamento como fraude suspeita (raw 59 ou 34). |
| 32 | O endereço de cobrança inserido não corresponde aos registros do banco. |
| 38 | O emissor recusou o pedido de isenção e exige 3D Secure para este pagamento. |
| 39 | O resultado do 3D Secure nunca chegou do servidor de diretório da bandeira do cartão. |
| 42 | O 3D Secure falhou por causa de um problema na rede do cartão ou no emissor. |
| 46 | A Adyen interrompeu a própria tentativa para que você não seja cobrado por taxas de penalidade do esquema por tentativas excessivas. |
| 50 | O comprador desativou o token que o lojista usava para cobranças recorrentes. |
Regras de nova tentativa
A Visa classifica as recusas em quatro categorias. A Categoria 1 (o emissor não aprovará, como cartão para reter, conta encerrada ou suspender pagamento) nunca deve ser tentada novamente. As Categorias 2, 3 e 4 permitem até 15 novas tentativas em 30 dias.
Os códigos de aviso da Mastercard 03 e 21 significam não tentar novamente, e a Mastercard cobra $0.10 por nova tentativa além de 10 em 24 horas para eles. Os códigos de aviso 24 a 30 dão novas tentativas cronometradas para fundos insuficientes.
O que dizer ao comprador
A Adyen aconselha não expor detalhes de recusa ou respostas brutas aos compradores. Use uma mensagem simples como "Seu pagamento foi recusado. Por favor, tente outro cartão ou entre em contato com seu banco."
Para desenvolvedores
As recusas retornam com HTTP 200, então verifique `resultCode`, `refusalReason` e `refusalReasonCode`. Habilite os resultados brutos do adquirente na Área do Cliente para obter `additionalData.refusalReasonRaw` e, para Visa e Mastercard na própria aquisição da Adyen, `refusalCodeRaw`. Os mesmos valores de recusa aparecem nos webhooks `CAPTURE_FAILED` e `REFUND_FAILED`.
Perguntas frequentes
- A PlatformDTC funciona com a Adyen?
- Não. O checkout da PlatformDTC funciona com Stripe e PayPal, e uma loja também pode conectar sua própria conta Authorize.Net, Checkout.com ou NMI.
- Onde vejo o código bancário real por trás de uma recusa da Adyen?
- Habilite os resultados brutos do adquirente na sua Área do Cliente da Adyen; as respostas incluirão então `refusalReasonRaw`, como 51 Insufficient funds.