Saltar al contenido principal
Para probar pagos con Card en general, Yuno ofrece el Yuno Test Payment Gateway. Funciona como una conexión, pero está disponible solo en el entorno de sandbox.

Conectar con Yuno

No se requieren API keys ni credenciales para conectar el Yuno Test Payment Gateway.

Información general

Configuración de la integración

Para conectar el Yuno Test Payment Gateway desde el dashboard:
  1. Inicia sesión en dashboard.y.uno.
  2. Ve a Connections y selecciona Yuno Test Payment Gateway.
  3. Haz clic en Connect.
  4. Ingresa un Name para la conexión.
  5. Haz clic en Connect.

Entorno de producción

Esta conexión está disponible solo para pruebas en sandbox y no se puede usar en producción.

Configurar el Yuno Test Payment Gateway

  1. Completa la Configuración de la integración del Test Payment Gateway.
  2. Después de establecer la conexión, debes designar el Yuno Test Payment Gateway como tu proveedor de pagos con tarjeta en la sección de enrutamiento. Accede a Routing en el Yuno Dashboard, selecciona Not published, busca la opción Card y haz clic en Set Up.
  1. Crea una nueva ruta para Card. Si no sabes cómo crearla, consulta Configurar el enrutamiento dinámico.
    1. En el dashboard de Routing, agrega condiciones para activar el pago con tarjeta. Por ejemplo, puedes usar la marca de la tarjeta o el país como condiciones.
    2. Para la condición creada, agrega el Yuno Test Payment Gateway.
    3. Para las opciones de All other payments, selecciona Cancel. La siguiente imagen muestra un ejemplo de configuración de enrutamiento donde se usó la condición de marca de tarjeta, aceptando pagos con las marcas Visa y Mastercard.
  1. Ahora debes hacer que las tarjetas estén disponibles para pruebas. Accede a Checkout builder en el Yuno Dashboard. Activa el interruptor de Card y publica el checkout con el botón Publish.
Usa la guía Crear pago para aprender a probar pagos con tarjeta.

Probar pagos con tarjeta con el Yuno Testing Gateway

En esta página encontrarás una guía paso a paso para crear un pago con tarjeta usando el Yuno Testing Gateway. Yuno Testing Gateway es una solución de Yuno para probar pagos con tarjeta en general. Funciona como una conexión. Sin embargo, solo está disponible en el entorno de sandbox.

Requisitos

Antes de comenzar con los pasos descritos en esta guía, necesitas: El proceso de creación de un pago normalmente requiere completar los dos pasos que se indican a continuación.
  1. Crear un cliente
  2. Crear el pago

Crear un pago

  1. Crear un cliente

Usa Crear cliente para registrar la información del cliente. Deberás proporcionar la información personal del cliente. Además, también debes enviar el merchant_customer_id, un identificador único del cliente usado en tu sistema.
Información complementaria del clienteAl crear un Customer, cierta información no es obligatoria, pero puede mejorar la experiencia de pago del usuario si se proporciona. El teléfono, la dirección de facturación y la dirección de envío son ejemplos de datos no obligatorios que puedes proporcionar. Si agregas información opcional, ten en cuenta los campos obligatorios que la acompañan.
Al final del proceso de creación del cliente, recibirás un id, que identifica al usuario dentro del sistema de Yuno. Usa el id para inicializar el checkout. Si estás creando un pago para un usuario existente que ya fue creado y ya tiene un id, puedes omitir este paso.

  1. Crear un pago

Crearás un pago usando el endpoint Create Payment. A continuación encuentras una descripción más detallada de cómo crear un pago. Proporciona la información relacionada con el cliente, incluido el objeto customer_payer que contiene el id del paso 1. Algunos objetos no son obligatorios al crear un pago. Sin embargo, si proporcionas esta información, la experiencia de pago del usuario mejorará. Ten en cuenta los campos obligatorios si deseas proporcionar esta información.

2.1 Elegir el tipo de captura

Yuno ofrece dos opciones para la captura del pago:
  • Un solo paso: la autorización y la captura se realizan simultáneamente. Solo necesitas crear el pago. La autorización y la captura se realizan automáticamente. Para la opción de un solo paso, debes enviar payment_method.detail.card.capture como true en la solicitud.
  • Dos pasos: la autorización y la captura se realizan en momentos distintos. Si deseas procesar el pago en dos pasos, envía payment_method.detail.card.capture como false cuando crees el pago y luego usa la solicitud Capture Authorization para completar el proceso.

2.2 Definir el flujo de trabajo del pago

Al crear el pago, debes indicar qué integración de Yuno estás usando. Debes indicarlo mediante el atributo workflow, que puede ser:
  • SDK_CHECKOUT: si usas el Yuno SDK para crear el pago (el valor por defecto).
  • DIRECT: si usas una integración back-to-back. Para usar este flujo de trabajo, debes cumplir con PCI.
  • REDIRECT: si usas una integración back-to-back y redirección del proveedor.
Indica la información del método de pago mediante el objeto payment_method. Selecciona el type del pago igual a CARD según la lista de tipos de pago. Además, debes agregar la información de la tarjeta en el objeto detail.card. Puedes usar la descripción del pago o datos específicos de la tarjeta para obtener el resultado deseado al probar un pago con el Yuno Test Payment Gateway. Las siguientes secciones describen cada enfoque en detalle.
Proceso del sistema de YunoEl sistema de Yuno sigue un proceso secuencial: primero examina los datos de la tarjeta y después evalúa la descripción proporcionada. Por lo tanto, si hay una discrepancia entre el estado indicado por los datos de la tarjeta y por la descripción en un pago de prueba, Yuno dará prioridad al estado asociado con los datos de la tarjeta y lo reflejará.
Para obtener el resultado de pago deseado mediante la descripción del pago, debes definir el resultado esperado como la descripción del pago que creas. Por ejemplo, si estás probando un pago y esperas un resultado exitoso, la descripción del pago debe ser “SUCCEEDED”. Encontrarás todas las opciones disponibles en la sección Códigos de transacción. En sandbox, puedes simular un contracargo después de una compra exitosa configurando la description del pago. El disparador es el campo de descripción, no el monto ni el número de tarjeta. Usa este formato como description del pago:
Reemplaza <outcome> por uno de los valores de la tabla siguiente. La compra se realiza con éxito primero. Unos dos minutos después, Yuno crea una transacción CHARGEBACK en ese pago y emite los eventos de webhook relacionados. Ejemplos:
  • SUCCEEDED+CHARGEBACK action_required
  • SUCCEEDED+CHARGEBACK review
  • SUCCEEDED+CHARGEBACK won
  • SUCCEEDED+CHARGEBACK lost
Si el resultado después de CHARGEBACK falta o no se reconoce, Yuno recurre a action_required. En las pruebas, el reason del contracargo observado es REQUESTED_BY_CUSTOMER.
Los datos de la tarjeta se evalúan primeroYuno evalúa los datos de la tarjeta antes que la descripción del pago, por lo que la tarjeta decide el resultado inicial de la autorización. La tarjeta no detiene la simulación del contracargo: aproximadamente un minuto después la descripción toma el control, el pago pasa a SUCCEEDED y el contracargo aún llega aproximadamente un minuto después. Combina la descripción SUCCEEDED+CHARGEBACK <outcome> con una tarjeta de prueba SUCCEEDED (o un prefijo de tarjeta SUCCEEDED equivalente) para que el estado del pago sea estable durante todo el flujo.
Confirma que tu endpoint de webhook en sandbox reciba payment.chargeback. Configura el endpoint en tu propia URL de sandbox y luego completa un contracargo simulado de principio a fin. Consulta Descripción general de webhooks, Configurar webhooks y los ejemplos de webhook de contracargo. Para conocer los estados de disputa y las acciones del comercio después de que llega el contracargo, consulta Gestión de contracargos.
Otra opción para obtener los resultados de pago esperados es usar una de las tarjetas de prueba que proporciona Yuno. En las tablas siguientes encuentras una lista de tarjetas y sus datos para usar con el Yuno Testing Gateway. La columna Código de respuesta de la transacción define el estado del pago devuelto cuando usas la tarjeta correspondiente.
NúmeroFecha de vencimientoCódigo de seguridadNombre del titular de la tarjetaCódigo de respuesta de la transacción
450799000000000211/28123John DoeSUCCEEDED
450799000000001011/28123John DoeINSUFFICIENT_FUNDS
450799000000002811/28123John DoeDECLINED_BY_BANK
450799000000003611/28123John DoeDO_NOT_HONOR
450799000000004411/28123John DoeINVALID_SECURITY_CODE
450799000000005111/28123John DoeINVALID_CARD_DATA
450799000000006911/28123John DoeREPORTED_STOLEN
450799000000007711/28123John DoeERROR
NúmeroFecha de vencimientoCódigo de seguridadNombre del titular de la tarjetaCódigo de respuesta de la transacción
525244000000000211/28123John DoeSUCCEEDED
525244000000001011/28123John DoeINSUFFICIENT_FUNDS
525244000000002811/28123John DoeDECLINED_BY_BANK
525244000000003611/28123John DoeDO_NOT_HONOR
525244000000004411/28123John DoeINVALID_SECURITY_CODE
525244000000005111/28123John DoeINVALID_CARD_DATA
525244000000006911/28123John DoeREPORTED_STOLEN
525244000000007711/28123John DoeERROR
NúmeroFecha de vencimientoCódigo de seguridadNombre del titular de la tarjetaCódigo de respuesta de la transacción
37000000000000211/281234John DoeSUCCEEDED
37000000000001011/281234John DoeINSUFFICIENT_FUNDS
37000000000002811/281234John DoeDECLINED_BY_BANK
37000000000003611/281234John DoeDO_NOT_HONOR
37000000000004411/281234John DoeINVALID_SECURITY_CODE
37000000000005111/281234John DoeINVALID_CARD_DATA
37000000000006911/281234John DoeREPORTED_STOLEN
37000000000007711/281234John DoeERROR
NúmeroFecha de vencimientoCódigo de seguridadNombre del titular de la tarjetaCódigo de respuesta de la transacción
364716600000000211/28123John DoeSUCCEEDED
364716600000001011/28123John DoeINSUFFICIENT_FUNDS
364716600000002811/28123John DoeDECLINED_BY_BANK
364716600000003611/28123John DoeDO_NOT_HONOR
364716600000004411/28123John DoeINVALID_SECURITY_CODE
364716600000005111/28123John DoeINVALID_CARD_DATA
364716600000006911/28123John DoeREPORTED_STOLEN
364716600000007711/28123John DoeERROR
NúmeroFecha de vencimientoCódigo de seguridadNombre del titular de la tarjetaCódigo de respuesta de la transacción
113900000000000211/28123John DoeSUCCEEDED
113900000000001011/28123John DoeINSUFFICIENT_FUNDS
113900000000002811/28123John DoeDECLINED_BY_BANK
113900000000003611/28123John DoeDO_NOT_HONOR
113900000000004411/28123John DoeINVALID_SECURITY_CODE
113900000000005111/28123John DoeINVALID_CARD_DATA
113900000000006911/28123John DoeREPORTED_STOLEN
113900000000007711/28123John DoeERROR
Para probar los reintentos de suscripciones y la cancelación por reintentos agotados con estas tarjetas, consulta Probar reintentos en sandbox.
Usa estas tarjetas y códigos OTP para probar los flujos de 3DS en nuestro entorno de preview mediante un simulador Netcetera Demo Merchant (NDM), configurado para simular un Directory Server y/o ACS con esquemas predefinidos y números de tarjeta de prueba. No se conecta a DS/ACS de prueba externos, solo ayuda a completar los flujos de 3DS con fines de prueba.
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ú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_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
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_N
4234123412340002NOT ENROLLED (VeRes is error 404 “Card account number not found in card ranges from Directory Server”)ENROLLED_N (NOT APPLICABLE)
4234123412340100MISSING_ROOT
4234123412340101MISSING_MESSAGE
4234123412340102INVALID_MESSAGE
4234123412340103MISSING_VERSION
4234123412340104ILLEGAL_VERSION
4234123412340105MISSING_URL
4234123412340106ILLEGAL_URL
4234123412340107MISSING_ENROLLED
4234123412340108ILLEGAL_ENROLLED
4234123412340109ILLEGAL_EXTENSION
4234123412340200ERROR_CUSTOM
4234123412340201ERROR_1
4234123412340202ERROR_2
4234123412340203ERROR_3
4234123412340204ERROR_4
4234123412340205ERROR_5
4234123412340206ERROR_6
4234123412340220ERROR_CUSTOM_WITH_DIFFERENT_MESSAGE_ID
4234123412340250ERROR_50
4234123412340251ERROR_51
4234123412340252ERROR_52
4234123412340253ERROR_53
4234123412340258ERROR_58
4234123412340298ERROR_98
4234123412340299ERROR_99
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
4234123412340400UNSUPPORTED_VERSION
4234123412340401UNRECOGNIZED_CRITICAL_EXTENSION
4234123412340402SERVER_ERROR
4234123412340403TIMEOUT
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
Rango inicialRango finalEsquema
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///

  1. Verificar el estado del pago

Después de realizar la solicitud a Create Payment, puedes verificar el estado del pago analizando status y sub_status de la respuesta. Consulta la página Estado del pago para ver todas las opciones que puedes recibir en la respuesta a la solicitud de creación del pago. Dependiendo del procesador y del método de pago, el estado puede tardar en actualizarse. Por lo tanto, es posible que debas usar endpoints para recuperar el estado del pago. Para ello, puedes usar los endpoints Retrieve Payment by ID o Retrieve Payment by merchant_order_id. Otra opción es usar webhooks para recibir notificaciones después de cada evento. Yuno recomienda usar webhooks para monitorear mejor los pagos asíncronos. Consulta la guía de Webhooks para aprender a configurar la solución de webhooks que ofrece Yuno.