Stripe · Códigos de recusa
O que significa o código de recusa Stripe authentication_not_handled?
Verificado em
O código de recusa authentication_not_handled do Stripe é um acompanhamento de authentication_required. O banco do cartão pediu para o titular do cartão verificar o pagamento, o pagamento prosseguiu sem essa verificação, e o banco o recusou novamente. A solução é executar a etapa 3D Secure (autenticação forte do cliente) e deixar o comprador completá-la. Para pagamentos feitos enquanto o cliente está ausente, Stripe aconselha preparar a autenticação enquanto o cliente está presente e recorrer a um pagamento em sessão, se necessário.
- Tipo
- Autenticação necessária (recusa suave)
- Quem recusou
- O banco do cartão
- Tentar novamente
- Somente com a etapa de verificação concluída
- Ação do comprador
- Pagar novamente e finalizar a tela de verificação do banco
- Ação do lojista
- Garantir que o checkout execute 3D Secure; trazer clientes fora da sessão de volta para confirmar
O que a PlatformDTC faz
O roteamento de checkout do PlatformDTC trata authentication_not_handled como um caso 3D Secure: o pagamento permanece no mesmo processador para verificação e nunca é oferecido a um processador de backup. Em renovações, no cronograma fixo ou com Smart retry, não é tentado novamente às cegas: a assinatura é mantida como vencida e o cliente recebe um e-mail de "ação necessária" pedindo para confirmar o pagamento com seu banco.
Por que acontece
Geralmente significa que uma integração ou fluxo permitiu que o pagamento continuasse sem mostrar o desafio do banco, ou que um cartão salvo foi cobrado sem a presença do cliente quando o banco queria que ele verificasse.
O que o comprador pode fazer
Voltar ao checkout e pagar novamente, e completar a janela de verificação ou a solicitação do aplicativo do banco quando ela aparecer.
O que a loja pode fazer
Se você vir isso com frequência, seu checkout está pulando a verificação que o banco pediu. Para assinaturas, colete e autentique o cartão enquanto o cliente estiver presente (quando ele assina pela primeira vez), e envie um link de confirmação por e-mail quando uma cobrança posterior pedir verificação novamente.
Para desenvolvedores
Orientação da Stripe: execute o fluxo EMV 3D Secure ou SCA; para pagamentos fora da sessão, colete e prepare a autenticação na sessão primeiro, depois retorne à sessão, se necessário. O valor está em last_payment_error.decline_code.
Perguntas frequentes
- Qual a diferença entre authentication_required e authentication_not_handled?
- authentication_required é o banco pedindo verificação. authentication_not_handled significa que o pagamento continuou sem essa verificação, então o banco recusou novamente.
- Tentar o mesmo pagamento novamente funcionará?
- Não sem verificação. O banco quer que o titular do cartão aprove o pagamento, então a nova tentativa tem que incluir a etapa 3D Secure.
Fontes
- Códigos de recusa da Stripe — Stripe
Relacionado
- authentication_required — O banco quer que o titular do cartão verifique o pagamento, geralmente com 3D Secure.
- payment_intent_authentication_failure — O cartão falhou na verificação de autenticação do banco (como 3-D Secure).
- mobile_device_authentication_required — O pagamento precisa de autenticação; o cliente deve tocar o telefone novamente.
- approve_with_id — O banco não conseguiu autorizar o pagamento como enviado; mais uma tentativa pode funcionar.
- call_issuer — O banco recusou sem um motivo e quer que o titular do cartão entre em contato com ele.
- card_not_supported — O cartão não pode ser usado para este tipo de compra.
- card_velocity_exceeded — O saldo, limite de crédito ou limite de valor do cartão foi atingido.
- currency_not_supported — O cartão não pode ser cobrado na moeda do pagamento.