Configurar o 3DS
Habilite o 3DS em uma conexão e coloque-o na estratégia de pagamento.
Nesta página
Configure o 3DS em quatro camadas: elegibilidade, conexão, estratégia de pagamento e experiência do comprador.
1. Confirme a elegibilidade#
Antes de alterar a configuração de produção:
- Verifique a conexão no catálogo de gateway de pagamento.
- Confirme os países, redes de cartões, moedas e operações de transação no escopo.
- Peça ao seu DEUNA TAM para confirmar se 3DS gerenciado por DEUNA, 3DS gerenciado por provedor ou ambos estão disponíveis para a conexão.
- Confirme se o desafio do emissor pode ser incorporado ou requer um redirecionamento de nível superior.
2. Escolha o modelo de autenticação#
Seu aplicativo comercial usa o mesmo pending_3ds e next_action contrato para ambos os modelos. Não use a identidade do provedor para decidir como o checkout se comporta.
Informações necessárias para 3DS gerenciado por DEUNA
Os campos exatos dependem da conexão de aquisição. Esteja pronto para fornecer:
| Configuração | Descrição |
|---|---|
| Identificador do comerciante | O identificador do comerciante ou afiliação registrado no adquirente. |
| BIN do adquirente | O identificador do banco adquirente atribuído à configuração do comerciante, quando necessário. |
| Nome e URL do comerciante | O nome do cliente e o URL seguro do site registrado para aceitação do cartão. |
| Código da categoria do comerciante | A MCC atribuída à conta do comerciante. |
| País | O país comerciante como um código ISO 3166-1 alfa-2. |
Trate esses valores como configuração de conexão. Não os envie do navegador nem os codifique em seu aplicativo cliente.
3. Habilite 3DS na conexão#
- No DEUNA Admin, abra Conexões.
- Selecione o gateway de pagamento utilizado pela estratégia.
- Abra as configurações de conexão e habilite o método de segurança compatível.
- Selecione o modelo 3DS acordado e preencha os campos solicitados do comerciante/adquirente.
- Salve a conexão, abra-a novamente e verifique se o 3DS permanece ativo no ambiente de destino.
Conexões
Descubra e gerencie integrações de pagamento, carteiras e antifraude.
| Conexões | Tipo | Status | Ação |
|---|---|---|---|
| Adyen | Gateway de pagamento | Conectada | |
| Worldpay | Gateway de pagamento | Conectada | |
| PayPal | Forma de pagamento | Conectada | |
| Mercado Pago | Forma de pagamento | Não conectada | |
| Riskified | Mecanismo antifraude | Não conectada |
Os rótulos de conexão e os campos disponíveis podem variar de acordo com o provedor. A capacidade DEUNA permanece a mesma: o checkout recebe um estado de pagamento normalizado e a próxima ação.
4. Aplique a estratégia de pagamento#
Habilitar o 3DS em uma conexão não define por si só quando ele deve ser executado. Em Estratégias de pagamento, confirme:
- qual tráfego de cartão é roteado através da conexão compatível com 3DS;
- se a autenticação é sempre solicitada ou selecionada pelas regras estratégicas;
- o que acontece depois que a autenticação é bem-sucedida, falha ou não pode ser concluída;
- se o roteamento de novas tentativas preserva um resultado de autenticação válido para uma próxima tentativa compatível.
Estratégias de pagamento
Configure o processamento padrão e as regras para cada fluxo de pagamento.
Processamento padrão
Configure o processamento padrão e as regras para cada fluxo de pagamento.
| Regra | Roteamento | Status | Ação |
|---|---|---|---|
| Processamento padrão | Adyen → Worldpay | Ativa |
Regras específicas
Configure o processamento padrão e as regras para cada fluxo de pagamento.
| Prioridade | Regra | Condições | Roteamento | Status |
|---|---|---|---|---|
| 1 | Pedidos de alto valor | Valor acima de USD 100 | Adyen → Worldpay | Ativa |
Consulte Estratégias de pagamento para comportamento padrão, condicional, de nova tentativa e de roteamento de risco.
5. Escolha a experiência do comprador#
| Produto | Implementação recomendada |
|---|---|
| Widget de pagamento | Deixe o widget apresentar o desafio integrado ou de redirecionamento compatível e retornar seus eventos de ciclo de vida. |
| Link de Pagamento | Deixe a experiência hospedada apresentar autenticação e usar a URL de retorno configurada. |
| API Direta | Prefira um DEUNA SDK compatível initNextAction fluxo. Caso contrário, use o URL do desafio retornado e respeite o modo de apresentação exigido. |
| Aplicativo nativo | Abra a próxima ação do DEUNA no SDK compatível ou em uma visualização da web do sistema seguro. Preserve o caminho de retorno/link direto do aplicativo. |
Nunca presuma que todas as páginas do emissor podem ser incorporadas. Os cabeçalhos de segurança do navegador, a política do emissor, o suporte de conexão e a configuração da conta podem exigir um redirecionamento de nível superior.
6. Lista de verificação de prontidão para produção#
- Teste um resultado sem atrito e verifique se nenhuma etapa desnecessária do comprador aparece.
- Teste um desafio e verifique a conclusão, o cancelamento, a navegação de volta e o comportamento de retorno do aplicativo/navegador.
- Mantenha
pending_3dsnão resolvido enquanto o comprador está autenticando. - Lidar com a expiração do desafio e um final
denied,cancelled, ouexpiredstatus. - Reconcilie o resultado do assinado DEUNA e o Obtenha o ponto final do pedido.
- Faça com que o cumprimento dependa de um status de pagamento final bem-sucedido, não do fechamento da tela de desafio.
- Confirme os cenários sandbox configurados com seu DEUNA TAM; o comportamento do teste pode variar de acordo com o modelo 3DS e a conexão de pagamento.
Continuar com fluxo de compra 3DS para implementar a API e o ciclo de vida de ação do cliente.