Gateway de Prueba de Yuno

Para probar pagos con tarjeta en general, Yuno proporciona el Yuno Test pago Gateway. Funciona como una conexión, sin embargo, sólo está disponible en el entorno sandbox.

Conectando con Yuno

Información general

Países:

Disponible en para todos los países.

Divisas:

Todas las monedas están disponibles.

Tipo de tarjetas:

Crédito, Débito y Prepago.

Datos de la prueba:

Información de la tarjeta para completar los pagos en modo de prueba.

Configuración de integración

Entorno de producción

Configurar la pasarela de pago de prueba de Yuno

1. Complete laconfiguración de la integración deGateway pago de prueba.
2. Después de establecer la conexión, debe designar el Yuno Test pago Gateway como su proveedor de pago tarjeta en su sección de enrutamiento. Acceda a Enrutamiento en el Panel de Control de Yuno, seleccione No publicado, busque la opción Tarjeta y haga clic en Configurar.

3. Crear una nueva ruta para Tarjeta. Si no está seguro de cómo crearlo, consulte como Configurar enrutamiento dinámico.
   1. En el dashboard de enrutamiento, agregue condiciones para activar el pago con tarjeta. Puede usar la marca de la tarjeta o el país como condiciones de activación, por ejemplo.
   2. Para la condición creada, agregue Yuno Test Payment Gateway.
   3. Para las opciones de Todos los demás pagos, seleccione la opción Cancelar. La siguiente imagen presenta un ejemplo de configuración de enrutamiento donde se utilizó la condición de marca de tarjeta, aceptando pagos con las marcas Visa y Mastercard.

4. Ahora necesitas hacer las tarjetas disponibles para probar. Acceda al Checkout Builder en el Dashboard de Yuno. Activa el botón de Card y publica el checkout usando el botón Publish.

Utilice la guía Crear pago para aprender a probar los pagos con tarjeta.

Pruebas de pagos con tarjeta usando Yuno Testing Gateway

En esta página, encontrarás una guía para crear una tarjeta de pago usando el Yuno Testing Gateway.

Yuno Testing Gateway es una solución de Yuno para probar pago con tarjeta en general. Funciona como una conexión. Sin embargo, sólo está disponible en el entorno sandbox.

Requisitos

Antes de comenzar a seguir los pasos descritos en esta guía, necesitas:

• Accede a tus Credenciales de API en Yuno Dashboard, que están compuestos por:
  • public-api-key
  • private-secret-key
  • account_id
• Configura la conexión de Yuno Testing Gateway en tu cuenta de Yuno Dashboard. Encontrarás una guía paso a paso para conectarlo en la sección Configuración de la integración.
• Construye una ruta para el Yuno Testing Gateway para definirlo como tu proveedor de pago tarjeta. Encontrarás una guía paso a paso de cómo hacerlo en la sección Configurar el Yuno Testing Gateway .
• Configure el checkout builder para que el Yuno Testing Gateway esté disponible.

Resumen de pasos

El proceso de creación de pago normalmente requiere completar los cuatro pasos que se enumeran a continuación.

1. Crear un Cliente
2. Crear una sesión de checkout
3. Crear un One-Time Token
4. Crear el pago

Crear un pago

1. Crear un cliente

Use el endpoint Crear Cliente para registrar la información del cliente. Deberá proporcionar información personal del cliente. Además, también debe proporcionar el merchant_customer_id, un identificador único para el cliente utilizado en su sistema.

📘

Información complementaria al cliente

Al crear un Cliente, cierta información no es obligatoria pero puede mejorar la experiencia de pago del usuario si se facilita. El teléfono, la dirección de facturación y la dirección de envío son ejemplos de datos no obligatorios que puede proporcionar. Si añade información opcional, tenga en cuenta los campos obligatorios.

Al finalizar el proceso de creación de un cliente, recibirá un id, que identifica al usuario dentro del sistema Yuno. Utilizar el id para inicializar el checkout.

Si está creando un pago para un usuario existente que se creó anteriormente y ya tiene un idpuedes omitir este paso.

2. Crear una sesión de checkout

Con un cliente registrado, puedes crear una sesión de checkout. El proceso de checkout es cuando el cliente finaliza su pedido y procede a pagar por los productos o servicios que desea adquirir. Por lo tanto, en esta etapa, proporcionarás información sobre el monto del pago y la ubicación donde se está creando.

🚧

Filtrado de condiciones de ruta

Al crear la ruta, puede definir condiciones que funcionen como filtros. Si ha usado el país como condición, verifique que el país proporcionado al crear la sesión de pago esté en la lista de condiciones. De lo contrario, es posible que Yuno Testing Gateway no procese el pago con tarjeta.

Use el endpoint Crear Sesión de Checkout endpoint. Note que el customer_id necesario para realizar la solicitud es el id que recibió al crear el cliente en el Paso 1.

De la solicitud de respuesta a la Crear Sesión de Checkout , recibirá el checkout_session . Se utilizará para crear el token único (OTT) y el pago en los siguientes pasos.

3. Crear un One-Time Token (OTT)

Un OTT es un identificador único que Yuno genera para proteger la privacidad y seguridad de tus clientes. Sirve como identificador para los detalles de los pagos y evita que datos sensibles se almacenen en tus servidores. Por lo tanto, puedes utilizar OTTs para facilitar que tus clientes repitan pagos sin tener que volver a ingresar tu información de pago, lo que hace que el proceso sea más seguro y conveniente.

Siempre obtendrás el OTT del SDK de Yuno en tu aplicación de producción. Sin embargo, para facilitar la prueba del proceso de creación de pagos, Yuno proporciona el endpoint Crear OTT . Deberá proporcionar la checkout_session recibido en Paso 2 y definir el tipo de pago como CARD a través de type parámetro. En la respuesta, recibirá el parámetro one-time-token, que utilizará para crear el pago.

4. Crea un pago

Creará un pago utilizando el endpoint Create Payment . A continuación encontrará una descripción más detallada de cómo crear un pago.

4.1 Proporcione los atributos requeridos

Proporcionar información relacionada con el cliente, incluida la checkout_session desde el Paso 2 hasta checkout.session y customer_payer objeto 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 será mejorada. Ten en cuenta los campos obligatorios si deseas proporcionar esta información.

4.2 Elige el tipo de captura

Yuno ofrece dos opciones para la captura de pagos:

• Un solo paso: La autorización y la captura se realizan simultáneamente. Solo necesitas crear el pago. La autorización y captura se realizan automáticamente. Para la opción de un solo paso, debe enviar el atributo capture atributo como true en la requisición
• Dos pasos: La autorización y la captura se realizan en momentos diferentes. Después de crear el pago, deberá realizar un pedido autorización y pedido captura. si desea procesar el pago en Dos Pasos, envíe capture como false y después de crear el pago, utiliza el Autorizar Pago y el Captura de Autorización para completar el proceso.

4.3 Definir el workflow de pago

Al crear el pago, debe informar qué integración de Yuno está utilizando. Al crear un pago, debe informarlo a través del workflow , que puede ser:

• CHECKOUT: si está utilizando el SDK de Yuno para crear el pago.
• DIRECT: si está utilizando una integración consecutiva. Para usar este workflow, debe cumplir con PCI.
• REDIRECT: si está utilizando una integración consecutiva y una redirección de proveedor.

4.4 Proporcione la información del método de pago

Informar la información del método de pago a través del objeto payment_method. Aquí usted proporcionará la one-time-token a través del atributo token y selecciona el pago type igual a CARD, el informado en Paso 3, basado en el Lista de tipos de pago. Además, debe agregar la información de la tarjeta en el objeto detail.card.

Puedes utilizar la descripción de pago o los datos específicos de la tarjeta para obtener el resultado deseado al probar el pago con la Pasarela de Prueba de Pago de Yuno. Las siguientes secciones describen en detalle cada enfoque.

📘

Proceso del sistema Yuno

El sistema Yuno sigue un proceso secuencial, examinando inicialmente los datos de la tarjeta y posteriormente evaluando la descripción proporcionada. En consecuencia, si hay una disparidad en el estado indicado por los datos de la tarjeta y la descripción para un pago de prueba, Yuno priorizará y reflejará el estado asociado con los datos de la tarjeta.

4.4.1 - Descripción de Pago

Para obtener el resultado de pago deseado utilizando la descripción de pago, debe definir el resultado esperado como la descripción del pago que cree. Por ejemplo, si está probando un pago y espera un resultado satisfactorio, la descripción del pago debe ser "SUCCEEDED". Encontrará todas las opciones disponibles en la sección Códigos de transacción.

4.4.2 - Detalle de la tarjeta

Otra opción para obtener los resultados de pago esperados es utilizar una de las tarjetas de prueba proporcionadas por Yuno. En las tablas de abajo, encontrará una lista de tarjetas y sus detalles de datos para usar cuando utilice el Gateway Pruebas de Yuno. La columna Código de Respuesta de Transacción define el estado de pago devuelto cuando se utiliza la tarjeta correspondiente.

4.4.3 - Tarjetas de prueba 3DS

Utilice estas tarjetas y códigos OTP para probar flujos 3DS en nuestro entorno de vista previa con un simulador Netcetera Demo Merchant (NDM), configurado para simular un servidor de directorio o ACS con esquemas predefinidos y números de tarjeta de prueba. No se conecta a un DS/ACS de prueba externo; solo ayuda a completar los flujos 3DS para fines de prueba.

5. Consulta el estado del pago

Después de realizar la solicitud al endpoint Crear Pago, puede verificar el estado del pago analizando el status y sub_status de la respuesta. Comprobar el Estado de pago para ver todas las opciones que puede recibir en respuesta a la solicitud de creación de pago.

Dependiendo del procesador y del método de pago, el estado puede tardar algún tiempo en actualizarse. Por lo tanto, puede que necesite utilizar endpoints para recuperar el estado de pago. Para realizar esta tarea, puede utilizar los endpoints Recuperar pago por ID o Recuperar pago por merchant_order_id. Otra opción es utilizar webhooks para recibir notificaciones después de cada evento. Yuno recomienda el uso de webhooks para monitorizar mejor los pagos asíncronos. Revisa la guía de Webhooks para aprender a configurar la solución de webhooks proporcionada por Yuno.