Integración de flujo directo

Cómo funciona

Si eres desarrollador, puedes utilizar nuestro Flujo Directo para continuar usando tu caja y conectarte a nuestros servicios usando únicamente una conexión de servidor a servidor.

Su empresa debe estar certificada PCI para utilizar nuestro servicio de pagos con tarjeta de servidor a servidor. Envíe su certificación AOC a su administrador de cuentas antes de comenzar la implementación.

❗️
Siempre recomendamos utilizar los SDK de Yuno en lugar de las integraciones de Direct Flow. Los SDK de Yuno cumplen con la normativa PCI y simplifican el proceso de pago al gestionar todas las complejidades, incluida la prevención de fraudes, 3DS y los requisitos específicos del proveedor de pagos. Direct Flow requiere que los comerciantes gestionen estos aspectos de forma manual, lo que aumenta la complejidad y el riesgo.

Para cada aplicación, recomendamos tomar el pago status y sub_status como referencia principal para el estado de pago. Un pago puede tener diferentes transacciones asociado a él, por lo que al centrarse en el pago estado/sub_estadopuede disponer del estado más reciente con independencia del número de transacciones realizadas, lo que le proporciona información clara para la toma de decisiones. Con esta integración, también puede enroll tarjetas de crédito para futuras compras (también disponible únicamente para comerciantes que cumplan la normativa PCI).

Payment

Paso 1: Crea un cliente

[Opcional]: El primer paso del flujo de pago es crear un cliente. Un cliente tendrá métodos de pago asociados. Puede crear un cliente utilizando el siguiente endpoint. Como resultado, recibirás el ID del cliente que fue creado en la base de datos de Yuno.

Puedes omitir este paso si previamente has creado el cliente.

Este paso es opcional porque puedes enviar la información del cliente directamente en el pago sin crear un objeto de cliente en Yuno.

🚧
Es necesario crear un cliente si deseas generar un vaulted_token.

Paso 2: Crear el pago

Como tú manejas toda la experiencia de pago con esta integración, necesitarás mostrar los métodos de pago habilitados en tu cuenta Yuno. Una vez que el usuario haya seleccionado el método de pago, puedes crear un pago. Un pago reúne todos los detalles cruciales con respecto a la orden, detalles del cliente, cantidad total, moneda, productos, detalles de envío, y más. Puede crear un pago utilizando el siguiente endpoint.

Puedes utilizar la sección de ejemplos en la referencia de la API como referencia. Si el usuario selecciona un método de pago previamente registrado, puede usar el vaulted_token devuelto por el servicio get payment methods para crear el pago.

Durante la integración, recomendamos tomar elestado y sub_estado del pago como referencia principal para el estado del pago. Un pago podría tener diferentes transacciones asociadas, por lo que si te centras en elestado/sub_estado del pago, podrás tener el estado más reciente independientemente de cuántas transacciones se hayan realizado, lo que te proporcionará una información clara para la toma de decisiones.

Flujo de trabajo DIRECTO vs REDIRECCIÓN

Al utilizar la integración Directa en Yuno, para Métodos de Pago Alternativos (PSE, Nequi, MercadoPago, PIX, etc.), tienes dos opciones workflow disponibles:

DIRECTO: Devolvemos la respuesta bruta de los proveedores para que puedas construir la experiencia como quieras con los datos sin filtrar.
REDIRECCION: Si bien también devolvemos la respuesta directa de los proveedores, ofrecemos a los comerciantes la posibilidad de usar un enlace de redirección proporcionado por Yuno, donde gestionamos la experiencia de pago únicamente para ese pago. Puede encontrar dicha URL en payment_method.detail.redirect_url campo en la respuesta del pago.

Complementos importantes

Webhooks: Recomendamos configurar Webhooks en tu panel de control de Yuno. Webhooks son la mejor manera de asegurar que su sistema se mantiene al día con el progreso y el estado de pago. Dado que las notificaciones de eventos se activan automáticamente, su sistema no tendrá que realizar solicitudes repetidas a Yuno.
Huellas dactilares del dispositivo: Las huellas digitales del dispositivo del cliente se utilizan con fines de prevención del fraude. Normalmente se generan utilizando JavaScript de terceros en el pago. Si utiliza una integración Direct y desea admitir proveedores de fraude en el flujo de pago, puede utilizar este objeto para especificar la información necesaria. Para integraciones que utilizan Yuno checkout, el valor se obtiene automáticamente, así que no envíe este campo.
- ```
[...]
"customer_payer": {
    "merchant_customer_id": "1690161049",
    "first_name": "Giovanna",
    "last_name": "Bartell",
    "email": "[email protected]",
     "device_fingerprints": [
        {
            "provider_id": "MERCADO_PAGO",
            "id": "20a6c463-dd0c-4323-9115-03668d178856"
        },
        {
            "provider_id": "CLEARSALE",
            "id": "92d2ea4b-4bf7-494b-aaea-c48276135941"
        }     
  }, 
[...]
```
three_d_secure_setup_id: Utiliza nuestro JS solo para obtener el three_d_secure_setup_id y luego manejar el pago como una única integración API. El flujo de trabajo directo solo está disponible para comerciantes que cumplen con PCI. Proporciona una forma sencilla de crear un pago y validar la información del usuario, lo que requiere que el comerciante realice una sola solicitud para crear el pago. Para implementar con éxito la integración directa, siga los pasos descritos en la directriz de integración y proporcionar la información requerida según las instrucciones. Este servicio no es necesario para la implementación de 3DS con el SDK de Yuno.

Registro

Paso 1: Crea un cliente

El primer paso del flujo de pago es crear un cliente. Un cliente tendrá métodos de pago asociados. Puede crear un cliente utilizando el siguiente endpoint. Como resultado, recibirás el ID del cliente que fue creado en la base de datos de Yuno.

Puedes omitir este paso si previamente has creado el cliente.

Paso 2: Registra un método de pago

📘
Integración de flujo directo
Esta función solo está disponible para inscribir tarjetas para comerciantes que cumplan con los requisitos PCI.

Una vez que tenga tu cliente, puede registrar el método de pago utilizando el endpoint de Inscribir método de pago . Con la información proporcionada por Yuno después de que el cliente selecciona el método de pago para inscribirse, podrá guardar esa información para futuras compras utilizando el vaulted_token que representa el objeto de método de pago creado.