Configuração e teste do 3DS

Use este guia passo a passo para configurar e testar o 3D Secure no Yuno. Você configurará uma conexão habilitada para 3DS e as credenciais do provedor, adicionará o 3DS ao seu roteamento, habilitará o cartão no Checkout Builder e validará os pagamentos usando o Yuno Testing Gateway, o Yuno SDK ou a API. Cartões de teste específicos do esquema, códigos OTP e notas de solução de problemas estão incluídos para verificar cenários sem atrito e desafiadores.

Teste de cartões para o fluxo 3DS

Use os cartões específicos do esquema abaixo para validar o 3DS na área restrita. No ambiente de visualização, um simulador simula o servidor de diretório (DS) e o servidor de controle de acesso (ACS) para que você possa testar os resultados sem atrito e com desafio. Cada tabela mostra o número do cartão com os resultados esperados do 3DS2 e as respostas VERes (Verification Response)/PARes (Payer Authentication Response) do 3DS1. Use os códigos de senha de uso único (OTP) no final para concluir os cenários de desafio.

Amex
Número do cartão Resposta esperada 3DS 2.x Resposta esperada 3DS 1.x DS (VERes) Resposta esperada 3DS 1.x ACS (PARes)
341502098634895AUTHENTICATED_APPLICATION_FRICTIONLESS (APLICATIVO AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_N
348638267931507DESAFIO_DO_NAVEGADORENROLLED_YTRANSACTION_CHALLENGE_OTP
345695399207589NOT_AUTHENTICATED_APPLICATION_FRICTIONLESS (APLICATIVO NÃO AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_N
349531373081938APPLICATION_CHALLENGEENROLLED_YTRANSACTION_STATUS_N
342316317472410APPLICATION_CHALLENGE_SDK_TRANS_ID_INVALID_FORMATENROLLED_YTRANSACTION_STATUS_N
347899129656655AUTHENTICATED_BROWSER_FRICTIONLESS (NAVEGADOR AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_N
345197771649926NOT_AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
372021106351394DESAFIO_DO_NAVEGADORENROLLED_YTRANSACTION_CHALLENGE_OTP
3734123412340000ENROLLED_YTRANSACTION_STATUS_N
3434567891111005ENROLLED_YTRANSACTION_CHALLENGE_OTP
3794521996036850ENROLLED_YTRANSACTION_CHALLENGE_OTP
Mastercard
Número do cartão Resposta esperada 3DS 2.x Resposta esperada 3DS 1.x DS (VERes) Resposta esperada 3DS 1.x ACS (PARes)
5333259155643223AUTHENTICATED_APPLICATION_FRICTIONLESS (APLICATIVO AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_Y
5306889942833340DESAFIO_DO_NAVEGADORENROLLED_YTRANSACTION_CHALLENGE_OTP
5328720384582224NOT_AUTHENTICATED_APPLICATION_FRICTIONLESS (APLICATIVO NÃO AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_N
5267648608924299APPLICATION_CHALLENGEENROLLED_YTRANSACTION_STATUS_N
5187434643593002APPLICATION_CHALLENGE_SDK_TRANS_ID_INVALID_FORMATENROLLED_YTRANSACTION_STATUS_N
5512459816707531AUTHENTICATED_BROWSER_FRICTIONLESS (NAVEGADOR AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_Y
5487971631330522NOT_AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
5424184049821670DESAFIO_DO_NAVEGADORENROLLED_YTRANSACTION_CHALLENGE_OTP
5204240438720050123DESAFIO_DO_NAVEGADORENROLLED_YTRANSACTION_CHALLENGE_OTP
5250548692069390ENROLLED_YTRANSACTION_CHALLENGE_OTP
5641523891636636ENROLLED_YTRANSACTION_CHALLENGE_OTP
Visto
Número do cartão Resposta esperada 3DS 2.x Resposta esperada 3DS 1.x DS (VERes) Resposta esperada 3DS 1.x ACS (PARes)
4556557955726624AUTHENTICATED_APPLICATION_FRICTIONLESS (APLICATIVO AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_Y
4916994064252017DESAFIO_DO_NAVEGADORENROLLED_YTRANSACTION_CHALLENGE_OTP
4556104160382032NOT_AUTHENTICATED_APPLICATION_FRICTIONLESS (APLICATIVO NÃO AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_N
4024007189449340APPLICATION_CHALLENGEENROLLED_YTRANSACTION_STATUS_N
4024007179872394APPLICATION_CHALLENGE_SDK_TRANS_ID_INVALID_FORMATENROLLED_YTRANSACTION_STATUS_N
4929251897047956AUTHENTICATED_BROWSER_FRICTIONLESS (NAVEGADOR AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_Y
4716429323842524NOT_AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
4234123412340003ENROLLED_YTRANSACTION_CHALLENGE_OTP
4604633194219929ENROLLED_YTRANSACTION_CHALLENGE_OTP
4485436455354151BROWSER_FRICTIONLESS_MISSING_DS_TRANS_ID
4556962659911995APPLICATION_FRICTIONLESS_MISSING_SDK_TRANS_IDENROLLED_YTRANSACTION_STATUS_N
4539837572943550BROWSER_FRICTIONLESS_MISSING_DS_TRANS_IDENROLLED_YTRANSACTION_STATUS_N
4024007176265022BROWSER_CHALLENGE_MISSING_ACS_URLENROLLED_YTRANSACTION_STATUS_N
4716125059847899TRÊS_RIENROLLED_YTRANSACTION_STATUS_N
4556362626719763PROTOCOL_ERRORENROLLED_YTRANSACTION_STATUS_N
4234123412340000ENROLLED_YTRANSACTION_STATUS_Y
4234123412340006ENROLLED_YTRANSACTION_STATUS_U
4234123412340007ENROLLED_YTRANSACTION_STATUS_A
4234123412340001ENROLLED_N
4234123412340002NOT ENROLLED (VeRes é o erro 404 "Número da conta do cartão não encontrado nos intervalos de cartões do servidor de diretório")ENROLLED_N (NÃO APLICÁVEL)
4234123412340100RAIZ AUSENTE
4234123412340101MISSING_MESSAGE
4234123412340102INVALID_MESSAGE
4234123412340103MISSING_VERSION
4234123412340104ILLEGAL_VERSION
4234123412340105MISSING_URL
4234123412340106ILLEGAL_URL
4234123412340107MISSING_ENROLLED
4234123412340108ILLEGAL_ENROLLED
4234123412340109ILLEGAL_EXTENSION
4234123412340200ERROR
4234123412340201ERROR
4234123412340202ERROR
4234123412340203ERROR
4234123412340204ERROR
4234123412340205ERROR
4234123412340206ERROR
4234123412340220ERROR
4234123412340250ERROR
4234123412340251ERROR
4234123412340252ERROR
4234123412340253ERROR
4234123412340258ERROR
4234123412340298ERROR
4234123412340299ERROR
4234123412340300IREQ_CUSTOM
4234123412340301IREQ_ENROLLED_Y
4234123412340350IREQ_50
4234123412340351IREQ_51
4234123412340352IREQ_52
4234123412340353IREQ_53
4234123412340354IREQ_54
4234123412340355IREQ_55
4234123412340356IREQ_56
4234123412340358IREQ_58
4234123412340398IREQ_98
4234123412340399IREQ_99
4234123412340400VERSÃO NÃO SUPORTADA
4234123412340401EXTENSÃO CRÍTICA NÃO RECONHECIDA
4234123412340402ERRO DO SERVIDOR
4234123412340403TEMPO LIMITE
Jantares
Número do cartão Resposta esperada 3DS 2.x Resposta esperada 3DS 1.x DS (VERes) Resposta esperada 3DS 1.x ACS (PARes)
3095000000000000AUTHENTICATED_APPLICATION_FRICTIONLESS (APLICATIVO AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_Y
3095000000000001DESAFIO_DO_NAVEGADORENROLLED_YTRANSACTION_CHALLENGE_OTP
3095000000000002NOT_AUTHENTICATED_APPLICATION_FRICTIONLESS (APLICATIVO NÃO AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_N
3095000000000005AUTHENTICATED_BROWSER_FRICTIONLESS (NAVEGADOR AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_Y
3095000000000006NOT_AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
JCB
Número do cartão Resposta esperada 3DS 2.x Resposta esperada 3DS 1.x DS (VERes) Resposta esperada 3DS 1.x ACS (PARes)
3528000000000000AUTHENTICATED_APPLICATION_FRICTIONLESS (APLICATIVO AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_Y
3528000000000001DESAFIO_DO_NAVEGADORENROLLED_YTRANSACTION_CHALLENGE_OTP
3528000000000002NOT_AUTHENTICATED_APPLICATION_FRICTIONLESS (APLICATIVO NÃO AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_N
3528000000000005AUTHENTICATED_BROWSER_FRICTIONLESS (NAVEGADOR AUTENTICADO SEM RESTRIÇÕES)ENROLLED_YTRANSACTION_STATUS_Y
3528000000000006NOT_AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
Faixas
Intervalo inicial Intervalo final Esquema
340000000000000349999999999999Amex
370000000000000379999999999999Amex
22210000000000002223000000000022Mastercard
22230000000000242720999999999999Mastercard
51000000000000005111111111111117Mastercard
51111111111111195599999999999999Mastercard
40000000000000004111110000000210Visto
41111100000002124234123412339999Visto
42341234123500004999999999999999Visto
30000000000000003099999999999999Jantares
35280000000000003589009999999999JCB
Códigos OTP do 3DS2
Código OTP Status da transação Motivo do status da transação ECI authenticationValue
1234Y/01JAmi21makAifmwqo2120cjq1AAA=
1111N0101/
2222R0101/
3333U0101/
4444A0101Qm181okmdyqh6yQmYuq1890QAAA=

Os mesmos códigos OTP são válidos para os cenários Visa, Mastercard e Amex.

Códigos OTP 3DS1
Código OTP Status da transação CAVV Algoritmo CAVV ECI
1234YVGhpcyBpcyBhIHRlc3QgYmFzZTY=705
1111N///

Configurar as conexões do 3D Secure

Primeiro, vamos configurar uma conexão habilitada para 3DS no painel do Yuno. Faça login em seu painel e navegue até Conexões. Nesse caso, usaremos o Yuno Test Payment Gateway como nosso provedor, portanto, vamos procurá-lo e clicar em Connect (Conectar).

Nomeie a conexão e ative a caixa de seleção de credenciais 3D Secure. Forneça os seguintes detalhes. Se precisar de credenciais de teste, entre em contato conosco e nós as forneceremos:

  • Nome do comerciante
  • URL do comerciante
  • Código do país do comerciante
  • MCC
  • Marca
  • Adquirente BIN
  • ID do comerciante adquirente
  • ID do comerciante
  • ID do canal de processamento (opcional)
  • Código do país do adquirente
  • SIRET (opcional)

Clique em Next para concluir todas as etapas e salvar sua conexão.

Em seguida, configure seu provedor 3DS (neste exemplo, usaremos o Cybersource 3DS). Em Connections (Conexões), selecione o provedor e clique em Connect (Conectar).

Nomeie a conexão e selecione 3D Secure em Tipo de integração. Usando as informações de seu provedor 3DS, preencha:

  • ID da organização
  • Secreto
  • Segredo compartilhado
  • Identificação da transação de
  • Tempo de expiração das transações (minutos) (opcional)

Configurar o roteamento

  • Navegue até Routing (Roteamento) e localize a rota do cartão na guia Published (Publicado) ou Not Published (Não publicado). Clique em View (Exibir ) ou Set Up (Configurar) e, em seguida, em Create new route (Criar nova rota).
  • Adicione uma etapa à rota: selecione Cybersource 3DS (ou seu provedor) e clique em Select (Selecionar).
  • Em seguida, no caminho "Succeeded", adicione Yuno Test Payment Gateway e clique em Select.
  • Clique em Publicar para salvar suas alterações.

Configurar o Checkout Builder

Navegue até Checkout Builder, ative o método de pagamento Card e clique em Publish settings (Publicar configurações) para salvar suas alterações.

Testando o 3DS com o Yuno

Você pode testar o 3D Secure de três maneiras:

  • Gateway de teste Yuno: Use o gateway configurado acima (somente sandbox).
  • Yuno SDK: Crie um pagamento em seu aplicativo usando o Yuno SDK.
  • API Yuno: Use os endpoints Criar cliente e Criar pagamento para executar um fluxo 3DS.

Consulte Teste de cartões para o fluxo 3DS acima para saber quais cartões de teste e códigos OTP devem ser usados.