Pular para o conteúdo principal
Nesta página

Use o Next Action quando um pedido existente requer que o cliente complete um passo adicional, como um desafio 3DS ou redirecionamento suportado. Reuse o token original do pedido.

Para 3DS, a experiência retornada pode primeiro coletar sinais do navegador e do dispositivo e depois continuar sem desafio ou exibir o desafio do emissor. Uma tela de carregamento não significa que o cliente precisa se autenticar manualmente. Mantenha o widget montado enquanto ele gerencia o fluxo e verifique o pedido original após um callback ou retorno. Consulte o fluxo de compra 3DS para conhecer as etapas e os resultados do pagamento.

Fluxo de decisão#

Diagrama de fluxo
NãoSimSucessoErro ou fechamento1Crie ou envie opagamento2Uma próxima ação foiretornada?3Trate o estado atualdo pedido4Abra Next Action como mesmo token dopedido5Resultado do widget6Reconcilie o pedidono backend7Consulte o estadoantes de tentarnovamente8Conclua a entregaapenas com um estadofinal verificado
ResultadoRevisão ou pendente
01 · response
Detecte a ação necessária
Use a resposta de pagamento ou o estado do pedido documentado.
02 · SDK
Abra o Next Action
Passar o token original order_token; do not create another order.
03 · customer
Continuar a autenticação
Deixe as verificações do navegador terminarem e apresente um desafio do emissor apenas quando necessário. Preserve redirecionamentos, popups e o retorno ao aplicativo.
04 · backend
Verifique o resultado
Obter o pedido ou consumir um webhook verificado.

Veja a experiência do cliente#

O Next Action funciona com os widgets de pagamento da DEUNA e com formulários de pagamento próprios do estabelecimento. Depois que seu backend enviar o pagamento, abra o Next Action somente quando a resposta indicar que o cliente precisa concluir outra etapa. O widget apresenta o desafio 3DS compatível ou o redirecionamento para um método de pagamento alternativo (APM) e informa o resultado por meio dos callbacks.

O passo a passo a seguir mostra como a experiência continua do checkout do estabelecimento até a ação pós-pagamento necessária:

O Next Action apresenta a etapa que o cliente precisa concluir após o início do pagamento. Assista ao vídeo diretamente no YouTube se o player incorporado não estiver disponível.

O vídeo mostra a transição apresentada ao cliente. Sua integração ainda deve usar a resposta do pagamento, os callbacks e a reconciliação no backend descritos abaixo; não deduza o estado final do pagamento com base no que o cliente vê no widget.

Abra o Next Action#

await DeunaSDK.initNextAction({
  orderToken,
  callbacks: {
    onSuccess: () => verifyOriginalOrder(),
    onError: (error) => recoverAfterVerification(error),
    onClosed: () => recoverAfterVerification(),
  },
});

Parâmetros#

ParâmetroPlataformasObrigatórioObjetivo
orderTokenTodosSimToken original para o pedido aguardando ação do cliente.
callbacksTodosSimSuporte para handlers de sucesso, erro, fechamento, evento e redimensionamento, conforme o contrato básico de callback.
languageTodosNãoLocaliza a experiência hospedada.
modeReagir nativoSimEscolher a apresentação modal ou integrada suportada.
fraudCredentialsNativo + React NativeNãoSomente para integração de dados de dispositivo configurada.
customUserAgentiOS + AndroidNãoOverride de agente de usuário WebView aprovado.
domainTodosNãoOverride de ambiente controlado; omitir no uso normal em produção.

Lidar com todas as situações#

ResultadoO que isso significaAção correta
onSuccessA etapa voltada para o cliente foi concluída.Obter o pedido original e renderizar a partir do seu estado atual.
onErrorO SDK ou desafio reportaram um erro normalizado.Registrar metadados seguros, obter o estado e, em seguida, oferecer uma tentativa elegível.
onClosedO cliente ou o SDK fecharam a experiência.Tratar como ambíguo até que o estado do backend seja conhecido.
Tempo limite ou interrupção do aplicativoNenhuma saída confiável do cliente foi alcançada pelo seu handler.Reconciliar a partir do backend; não submeter automaticamente novamente.

Requisitos de redirecionamento e pop-up#

  • Permitir que o SDK abra a superfície de autenticação externa suportada.
  • Preservar o estado do ciclo de vida do aplicativo enquanto o cliente sai e retorna.
  • No Web, abrir a partir de uma ação do cliente e não "sandboxing" o widget de forma a bloquear pop-ups ou navegação de nível superior.
  • No React Native, manter o renderizador do SDK montado enquanto o controlador de redirecionamento externo estiver ativo.
  • No iOS e Android, use o modal ou componente embutido mantido do SDK em vez de recriar a ponte WebView interna.
  • Teste de sucesso para desafio, rejeição, cancelamento do cliente, timeout do emissor, perda de rede e retorno do modo de fundo.

Interface integrada#

O SDK Web suporta mode: 'target' mais target; iOS e Android expõem componentes de widget integrados; React Native usa seu DeunaWidget renderizador. Reserve altura inicial suficiente, responda a mudanças de tamanho e garanta que o host não oculte os controles de desafio atrás de um rodapé fixo ou teclado na tela.

Fallback de carregamento do iframe 3DS#

Quando a DEUNA apresenta um desafio 3DS dentro de um iframe, a Next Action monitora o estado de carregamento da visualização do emissor.

  • Se o iframe carregar com sucesso nos primeiros 5 segundos, o fluxo continua normalmente e nenhuma ação de recuperação adicional é exibida.
  • Se a visualização não terminar de carregar após 5 segundos, o A visualização falhou ao carregar? aparece a opção.

Quando expandido, o comprador pode:

  • Recarregar visualização: tenta novamente carregar o desafio 3DS.
  • Alterar método de pagamento: permite que o comprador saia do desafio atual e selecione outro método de pagamento, após confirmar a ação.

Se o iframe terminar de carregar enquanto o fallback estiver visível, as opções de recuperação são ocultadas automaticamente e o comprador pode continuar com o desafio.

Comportamento de integração

AçãoComportamentoCallback / evento
Pagamento vai para a visualização 3DSA visualização incorporada 3DS é exibida, ou o usuário é redirecionado para outra aba.evento paymentMethods3dsInitiated.
Iframe carregaO desafio 3DS continua normalmenteNenhuma ação adicional do merchant é necessária
Alterar método de pagamentoA experiência atual é abandonada após confirmaçãoevento apmCancelPayment.
Desafio concluídoO fluxo normal de Next Action continuacallback onSuccess / evento purchase / resultado correspondente
Desafio negado / expiradoDesafio negado no redirecionamento, o fluxo termina aqui.evento purchaseError / callback onError

O merchant deve continuar usando os callbacks de Next Action e o status autoritativo do pedido para determinar o resultado final do pagamento.