El proceso de pago de Yuno
El proceso de pago consta de los siguientes pasos:1
Crea un cliente
En Yuno, los pagos normalmente se vinculan a un cliente. El sistema guarda datos del cliente como el nombre, la dirección y el número de teléfono. Yuno usa esta información para procesar pagos con distintos métodos de pago y procesadores.
Cuando creas un cliente, Yuno genera un identificador único que se usa en los pasos siguientes.
Se puede crear un pago sin un cliente. Si creas la sesión de checkout con un
customer_id, envía el mismo cliente en customer_payer.id cuando crees el pago.2
Crea una sesión de checkout
Para procesar un pago con el Yuno SDK o el Checkout, crea una sesión de checkout. Esta sesión conecta al cliente con el pago y guarda los datos clave de la transacción. Yuno carga todos los métodos de pago disponibles vinculados a tu cuenta.
Las integraciones directas (servidor a servidor) omiten este paso y envían los datos de la transacción directamente al crear el pago. Define
workflow como DIRECT (o REDIRECT) en la solicitud de pago. Sin ese valor, la API pide el objeto checkout.3
Recopila los datos de pago
Para procesar un pago, necesitas recopilar la información de pago del cliente.
- Integración con SDK: los SDKs de Yuno capturan los datos sensibles de forma segura y generan un token de un solo uso (OTT).
- Integración directa: recopilas los datos de pago directamente en tus servidores (lo que requiere cumplimiento PCI) y los envías al endpoint de pagos.
Un OTT es un código temporal de un solo uso que los SDKs de Yuno usan para reforzar la seguridad de los comercios.
4
Crea el pago
Un pago representa la transacción final. Usa los datos recopilados en los pasos anteriores (el ID del cliente y la información de pago) para procesar la transacción final.
Algunos campos son opcionales, pero pueden mejorar la experiencia del usuario. Ten en cuenta los campos obligatorios si decides incluir esta información.
La solicitud de creación de pago requiere el encabezado
X-Idempotency-Key. Envía un valor único (por ejemplo, un UUID) para poder reintentar la solicitud de forma segura. Consulta Idempotencia.