Saltar al contenido principal
Usa esta guía paso a paso para configurar y probar 3D Secure en Yuno. Configurarás una conexión con 3DS habilitado y las credenciales del proveedor, agregarás 3DS a tu enrutamiento, habilitarás Card en Checkout Builder y validarás pagos con el Yuno Testing Gateway, el Yuno SDK o la API. Incluye tarjetas de prueba por esquema, códigos OTP y notas de solución de problemas para verificar los escenarios sin fricción y con desafío.

Tarjetas de prueba para el flujo 3DS

Usa las tarjetas por esquema que aparecen abajo para validar 3DS en sandbox. En el entorno de vista previa, un simulador imita el Directory Server (DS) y el Access Control Server (ACS) para que puedas probar resultados sin fricción y con desafío. Cada tabla muestra el número de tarjeta con los resultados esperados de 3DS2 y las respuestas VERes (Verification Response) y PARes (Payer Authentication Response) de 3DS1. Usa los códigos de contraseña de un solo uso (OTP) del final para completar los escenarios con desafío.
Número de tarjetaRespuesta esperada 3DS 2.xRespuesta esperada 3DS 1.x DS (VERes)Respuesta esperada 3DS 1.x ACS (PARes)
341502098634895AUTHENTICATED_APPLICATION_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_Y
348638267931507BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
345695399207589NOT_AUTHENTICATED_APPLICATION_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
349531373081938APPLICATION_CHALLENGEENROLLED_YTRANSACTION_STATUS_N
342316317472410APPLICATION_CHALLENGE_SDK_TRANS_ID_INVALID_FORMATENROLLED_YTRANSACTION_STATUS_N
347899129656655AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_Y
345197771649926NOT_AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
372021106351394BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
3734123412340000NOT_AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
3434567891111005BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
3794521996036850BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
Número de tarjetaRespuesta esperada 3DS 2.xRespuesta esperada 3DS 1.x DS (VERes)Respuesta esperada 3DS 1.x ACS (PARes)
5333259155643223AUTHENTICATED_APPLICATION_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_Y
5306889942833340BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
5328720384582224NOT_AUTHENTICATED_APPLICATION_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
5267648608924299APPLICATION_CHALLENGEENROLLED_YTRANSACTION_STATUS_N
5187434643593002APPLICATION_CHALLENGE_SDK_TRANS_ID_INVALID_FORMATENROLLED_YTRANSACTION_STATUS_N
5512459816707531AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_Y
5487971631330522NOT_AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
5424184049821670BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
5204240438720050123BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
5250548692069390BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
5641523891636636BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
N/A significa que el caso de prueba genera un error de protocolo o de transporte antes de llegar a la etapa del DS o del ACS, por lo que no se devuelve ninguna respuesta del DS/ACS para esa tarjeta.
Número de tarjetaRespuesta esperada 3DS 2.xRespuesta esperada 3DS 1.x DS (VERes)Respuesta esperada 3DS 1.x ACS (PARes)
4556557955726624AUTHENTICATED_APPLICATION_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_Y
4916994064252017BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
4556104160382032NOT_AUTHENTICATED_APPLICATION_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
4024007189449340APPLICATION_CHALLENGEENROLLED_YTRANSACTION_STATUS_N
4024007179872394APPLICATION_CHALLENGE_SDK_TRANS_ID_INVALID_FORMATENROLLED_YTRANSACTION_STATUS_N
4929251897047956AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_Y
4716429323842524NOT_AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
4234123412340003BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
4604633194219929BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
4485436455354151BROWSER_FRICTIONLESS_MISSING_DS_TRANS_IDN/AN/A
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
4716125059847899THREE_RIENROLLED_YTRANSACTION_STATUS_N
4556362626719763PROTOCOL_ERRORENROLLED_YTRANSACTION_STATUS_N
4234123412340000AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_Y
4234123412340006UNAVAILABLE_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_U
4234123412340007ATTEMPTED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_A
4234123412340001NOT_ENROLLEDENROLLED_NN/A
4234123412340002NOT ENROLLED (VeRes es el error 404 “Card account number not found in card ranges from Directory Server”)ENROLLED_N (NOT APPLICABLE)N/A
4234123412340100MISSING_ROOTN/AN/A
4234123412340101MISSING_MESSAGEN/AN/A
4234123412340102INVALID_MESSAGEN/AN/A
4234123412340103MISSING_VERSIONN/AN/A
4234123412340104ILLEGAL_VERSIONN/AN/A
4234123412340105MISSING_URLN/AN/A
4234123412340106ILLEGAL_URLN/AN/A
4234123412340107MISSING_ENROLLEDN/AN/A
4234123412340108ILLEGAL_ENROLLEDN/AN/A
4234123412340109ILLEGAL_EXTENSIONN/AN/A
4234123412340200ERROR_CUSTOMN/AN/A
4234123412340201ERROR_1N/AN/A
4234123412340202ERROR_2N/AN/A
4234123412340203ERROR_3N/AN/A
4234123412340204ERROR_4N/AN/A
4234123412340205ERROR_5N/AN/A
4234123412340206ERROR_6N/AN/A
4234123412340220ERROR_CUSTOM_WITH_DIFFERENT_MESSAGE_IDN/AN/A
4234123412340250ERROR_50N/AN/A
4234123412340251ERROR_51N/AN/A
4234123412340252ERROR_52N/AN/A
4234123412340253ERROR_53N/AN/A
4234123412340258ERROR_58N/AN/A
4234123412340298ERROR_98N/AN/A
4234123412340299ERROR_99N/AN/A
4234123412340300IREQ_CUSTOMN/AN/A
4234123412340301IREQ_ENROLLED_YN/AN/A
4234123412340350IREQ_50N/AN/A
4234123412340351IREQ_51N/AN/A
4234123412340352IREQ_52N/AN/A
4234123412340353IREQ_53N/AN/A
4234123412340354IREQ_54N/AN/A
4234123412340355IREQ_55N/AN/A
4234123412340356IREQ_56N/AN/A
4234123412340358IREQ_58N/AN/A
4234123412340398IREQ_98N/AN/A
4234123412340399IREQ_99N/AN/A
4234123412340400UNSUPPORTED_VERSIONN/AN/A
4234123412340401UNRECOGNIZED_CRITICAL_EXTENSIONN/AN/A
4234123412340402SERVER_ERRORN/AN/A
4234123412340403TIMEOUTN/AN/A
Número de tarjetaRespuesta esperada 3DS 2.xRespuesta esperada 3DS 1.x DS (VERes)Respuesta esperada 3DS 1.x ACS (PARes)
3095000000000000AUTHENTICATED_APPLICATION_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_Y
3095000000000001BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
3095000000000002NOT_AUTHENTICATED_APPLICATION_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
3095000000000005AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_Y
3095000000000006NOT_AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
Número de tarjetaRespuesta esperada 3DS 2.xRespuesta esperada 3DS 1.x DS (VERes)Respuesta esperada 3DS 1.x ACS (PARes)
3528000000000000AUTHENTICATED_APPLICATION_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_Y
3528000000000001BROWSER_CHALLENGEENROLLED_YTRANSACTION_CHALLENGE_OTP
3528000000000002NOT_AUTHENTICATED_APPLICATION_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
3528000000000005AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_Y
3528000000000006NOT_AUTHENTICATED_BROWSER_FRICTIONLESSENROLLED_YTRANSACTION_STATUS_N
Inicio del rangoFin del rangoEsquema
340000000000000349999999999999Amex
370000000000000379999999999999Amex
22210000000000002223000000000022Mastercard
22230000000000242720999999999999Mastercard
51000000000000005111111111111117Mastercard
51111111111111195599999999999999Mastercard
40000000000000004111110000000210Visa
41111100000002124234123412339999Visa
42341234123400004234123412349999Visa
42341234123500004999999999999999Visa
30000000000000003099999999999999Diners
35280000000000003589009999999999JCB
Código OTPEstado de la transacciónMotivo del estado de la transacciónECIauthenticationValue
1234Y/01JAmi21makAifmwqo2120cjq1AAA=
1111N0101/
2222R0101/
3333U0101/
4444A0101Qm181okmdyqh6yQmYuq1890QAAA=
Los mismos códigos OTP son válidos para los escenarios de Visa, Mastercard y Amex.
Código OTPEstado de la transacciónCAVVAlgoritmo CAVVECI
1234YVGhpcyBpcyBhIHRlc3QgYmFzZTY=705
1111N///

Set up the 3D Secure connections

Primero, configuraremos una conexión con 3DS habilitado en el dashboard de Yuno. Inicia sesión en tu dashboard y ve a Connections. En este caso, usaremos Yuno Test Payment Gateway como proveedor, así que búscalo y haz clic en Connect.
Yuno dashboard Connections page searching yuno, showing Yuno 3DS and Yuno Test Payment Gateway cards with Connect buttons
Asigna un nombre a la conexión y habilita la casilla de credenciales de 3D Secure. Proporciona los siguientes datos. Si necesitas credenciales de prueba, contáctanos y te las proporcionaremos:
  • Nombre del comercio (Merchant Name)
  • URL del comercio (Merchant URL)
  • Código de país del comercio (Merchant Country Code)
  • MCC
  • Marca (Brand)
  • Acquirer BIN
  • ID del comercio del adquirente (Acquirer Merchant ID)
  • ID del comercio (Merchant ID)
  • ID del canal de procesamiento (Processing Channel ID) (opcional)
  • Código de país del adquirente (Acquirer Country Code)
  • SIRET (opcional)
Los valores Acquirer BIN y Acquirer Merchant ID son específicos de cada marca y están registrados en el Directory Server de cada esquema de tarjeta. Un BIN registrado para una marca no funciona para otra, y los identificadores de membresía, como el ICA de Mastercard o el Seller ID de Amex, no son BIN del adquirente. Consulta Configuración de 3D Secure para tus pagos para saber cómo solicitar los valores correctos a tu adquirente.
Haz clic en Next para completar todos los pasos y en Save para guardar tu conexión. Luego, configura tu proveedor de 3DS (en este ejemplo usaremos Cybersource 3DS). En Connections, selecciona el proveedor y haz clic en Connect. Asigna un nombre a la conexión y selecciona 3D Secure en Integration type. Con la información de tu proveedor de 3DS, completa:
  • ID de la organización (Organization ID)
  • Secreto (Secret)
  • Secreto compartido (Shared Secret)
  • Origen de la identificación de la transacción (Transaction identification from)
  • Tiempo de expiración de las transacciones en minutos (Transactions expire time) (opcional)
Edit Cybersource 3DS connection form with name, organization ID, secret, shared secret, and transaction identification fields

Configurar el enrutamiento

  • Ve a Routing y busca la ruta Card en la pestaña Published o Not Published. Haz clic en View o Set Up y luego en Create new route.
  • Agrega un paso a la ruta: selecciona Cybersource 3DS (o tu proveedor) y haz clic en Select.
  • Luego, en la ruta de “Succeeded”, agrega Yuno Test Payment Gateway y haz clic en Select.
  • Haz clic en Publish para guardar tus cambios.
Routing editor with Cybersource3ds as first step and Yuno Test Payment Gateway on its Succeeded path, plus Publish button

Configurar Checkout Builder

Ve a Checkout Builder, habilita el método de pago Card y luego haz clic en Review & publish para guardar tus cambios.
Checkout builder payment method settings with Card enabled, a display order preview, and Publish settings button

Probar 3DS con Yuno

Puedes probar 3D Secure de tres maneras:
  • Yuno Testing Gateway: usa el gateway configurado arriba (solo sandbox).
  • Yuno SDK: crea un pago en tu aplicación con el Yuno SDK.
  • Yuno API: usa los endpoints Create Customer y Create Payment para ejecutar un flujo 3DS.
Consulta las Tarjetas de prueba para el flujo 3DS de arriba para ver las tarjetas y los códigos OTP que debes usar.