Headless SDK (Pago)

Yuno Headless SDK le ofrece un control total sobre la interfaz de usuario y la experiencia de pago sin necesidad de cumplir la normativa PCI. Con Headless SDK SDK, puede realizar pagos con tarjeta o inscribir información de tarjetas en las cuentas de sus clientes. Acceda a Headless SDK (Inscripción) para obtener más información. Esta página cubre la operación de pago. A continuación puede consultar las guías disponibles.

Workflow de pago

El diagrama a continuación ilustra el flujo de trabajo completo de pago. Cada paso se explica en detalle en las siguientes secciones. Para obtener información sobre la implementación específica de cada plataforma, consulte la guía correspondiente.

Flujo de pago sin interfaz del SDK

Este diagrama ilustra el proceso de pago headless con el SDK, detallando las interacciones entre el Cliente Comercial, el Servidor Comercial, el Servidor Yuno y el SDK Yuno. Describe los pasos desde el inicio del proceso de compra y la solicitud de métodos de pago hasta la creación y recepción del resultado del pago.

Cliente comercial

El Cliente Comercial representa tu aplicación frontend que interactúa con su servidor backend y el SDK de Yuno. Gestiona los aspectos del flujo de pago orientados al usuario, incluyendo:

• Iniciar el pago
• Lista de métodos de pago
• El usuario selecciona los métodos de pago
• Iniciar SDK con sesión de pago y método de pago
• Obtiene token (uso único)
• Iniciar pago

Servidor comercial

El Servidor Comercial representa la aplicación backend que gestiona las operaciones del servidor y se comunica con los servidores de Yuno. Sus principales responsabilidades incluyen:

• Crear Cliente
• Crear sesión de pago
• Solicitar método de pago disponible
• Crear pago
• Recibir el resultado del pago a través del webhook

Servidor Yuno

El servidor Yuno gestiona todas las operaciones de backend relacionadas con la gestión de clientes, las sesiones de pago y el procesamiento de pagos. Sus principales responsabilidades incluyen:

• Crea Cliente
• Crea una sesión de pago
• Método de pago disponible para devoluciones
• Crea el pago en el proveedor de pagos.
• Recibir resultados de pago del proveedor de pagos

SDK de Yuno

El SDK de Yuno gestiona la interfaz de usuario y el flujo de pago del cliente, gestionando la selección del método de pago, la generación de tokens y la finalización del pago. Sus principales responsabilidades incluyen:

• Recibe la sesión de pago y el método de pago seleccionado por el usuario
• Devolución de llamada con el token de un solo uso

Fluir

Los siguientes pasos describen el flujo de interacción completo entre todos los componentes de la integración de pago de SDK Headless y detallan cómo cada solicitud y respuesta se mueve a través del sistema:

1. Servidor comercial: Crear cliente --> Servidor Yuno: Crea cliente
2. Cliente comercial: Iniciar el pago --> Servidor comercial: Crear sesión de pago
3. Servidor comercial: crear sesión de pago --> Servidor Yuno: crear sesión de pago
4. Cliente comercial: enumerar métodos de pago --> Servidor comercial: solicitar el método de pago disponible
5. Servidor comercial: Solicitar método de pago disponible --> Servidor Yuno: Devuelve el método de pago disponible
6. Cliente comercial: enumera los métodos de pago --> Cliente comercial: el usuario selecciona los métodos de pago
7. Cliente comercial: el usuario selecciona los métodos de pago --> Cliente comercial: inicia el SDK con la sesión de pago y el método de pago
8. Cliente comercial: inicia el SDK con la sesión de pago y el método de pago --> SDK de Yuno: recibe la sesión de pago y el método de pago seleccionados por el usuario
9. SDK de Yuno: recibe la sesión de pago y el método de pago seleccionado por el usuario --> SDK de Yuno: devolución de llamada con el token de un solo uso
10. SDK de Yuno: devolución de llamada con el token de un solo uso --> Cliente comercial: obtiene el token (uso único)
11. Cliente comercial: obtiene el token (un solo uso) --> Cliente comercial: inicia el pago
12. Cliente comercial: Iniciar pago --> Servidor comercial: Crear pago
13. Servidor comercial: Crea el pago --> Servidor Yuno: Crea el pago en el proveedor de pagos
14. Servidor comercial: recibe el resultado del pago a través del webhook --> Servidor Yuno: recibe los resultados del pago del proveedor de pagos

📘

Elige tu integración

El Headless SDK está diseñado para aceptar pagos usando sólo tarjetas. Si necesitas realizar un pago usando otro método de pago, necesitas elegir otra integración de Yuno:

• Full SDK
• Lite SDK
• Flujo Directo

Registre una tarjeta de crédito mientras paga

Con Headless SDK, puede guardar tarjetas de crédito/débito para futuras compras dentro de la misma solicitud de pago sin la inscripción integración. Puedes obtener el token almacenado mientras se ejecuta el apiClientPayment.generateToken funcionar en Paso 4.

Proporcione una casilla de verificación en tu proceso de pago para que los usuarios eligen si desean guardar su tarjeta para usarla en el futuro. Si el usuario selecciona esta opción, configure payment_method.card.save = true al llamar al apiClientPayment.generateToken función. Recibirás el vaulted_token en la respuesta de la función.

📘

Métodos de pago alternativos

Para inscribir métodos de pago alternativos, consulte la página Lite SDK (Inscripción).

Después de inscribirse en un método de pago, puede utilizar el token almacenado para realizar pagos. Para acceder a información sobre los métodos de pago registrados por cada usuario, puede utilizar uno de los siguientes endpoints:

• Obtener métodos de pago por sesión de pago.
• Obtener métodos de pago por cliente.

🚧

Usando un vaulted token

Incluso si el usuario selecciona un método de pago registrado, Yuno recomienda usar el SDK para tokenizar la información en lugar de usar directamente el token almacenado con la API de Yuno. Este enfoque proporciona varios beneficios:

• Soporte 3DS: Mayor seguridad para los pagos en línea.
• Detección de fraudes: Mejor protección contra las transacciones fraudulentas.
• Recopile la información requerida: Recopile los campos adicionales requeridos por el proveedor si es necesario.

Para ello, envíe el comando vaultedToken al montar el SDK. El SDK se encargará del resto. Si el método de pago requiere un paso adicional (como un desafío 3DS), utilice el método yuno.continuePayment() método. Este método gestiona cualquier redirección necesaria y funciona tanto para los métodos de pago inscritos como para los normales que necesitan acciones adicionales por parte del cliente.