Registrar Métodos de pago

Esta página te guiará para inscribir un método de pago en una cuenta de cliente y obtener un vaulted_token Para futuras compras.

📘

Token en bóveda

Se crea un token almacenado en bóveda una vez que se registra un método de pago y se almacena con la información del cliente. Puede utilizar el token almacenado en bóveda creado para identificar el método de pago en pagos futuros.

El servicio de tokenización y la bóveda centralizada de Yuno te permiten gestionar pagos recurrentes, retrocesos y reintentos entre procesadores sin comprometer la UX. Los siguientes métodos de pago están disponibles para la inscripción en Yuno:

Métodos de pago disponibles para la inscripción

(*) Sólo SDK. Consulta la documentación del SD K para conocer los detalles de la integración.

Requisitos

Antes de iniciar el proceso de inscripción, es necesario:

• Accede a tus Credenciales de API en Yuno Dashboard, que están compuestos por:
  • public-api-key
  • private-secret-key
  • account_id
• Configura tus conexiones en tu cuenta de Yuno Dashboard. Añade un método de pago que requiera inscripción.
• Construye una ruta para el método de pago para definir cómo será procesado.
• Configure el generador de pagos para que sus pagos conectados estén disponibles.

Resumen de pasos

Para registrar un método de pago en una cuenta de cliente, deberá seguir los pasos que se detallan a continuación.

1. Crear un Cliente
2. Crear sesión de cliente (exclusivo para el flujo de trabajo de pago)
3. (Opcional) Recuperar métodos de pago disponibles para inscribirse - Flujo de trabajo de pago
4. Método de pago Enroll Checkout workflow/Directworkflow
5. Recuperar métodos de pago - Flujo de trabajo directo

Registra un método de pago

Paso 1: Crea 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 del 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 requeridos.

Al finalizar el proceso de creación de un cliente, recibirá un id, que identifica al usuario dentro del sistema Yuno. Si está registrando un método de pago para un usuario existente, que se creó anteriormente y ya tenía un id, puede omitir este paso.

Paso 2: Crear una sesión de cliente

🚧

Requisitos del flujo de trabajo

El proceso de inscripción varía según el tipo de método de pago:

• Flujo de trabajo de pago: Requiere sesión de cliente para la mayoría de métodos de pago (Tarjetas, Nupay, PayPal, Daviplata, métodos dLocal, Astropay, Adyen PIX Biométrico)
• Flujo de trabajo directo: Disponible sólo para Tarjetas (comercios que cumplen la normativa PCI). Procede directamente al Paso 3 utilizando el cliente id generado en el Paso 1.
• Flujo de trabajo SDK: los métodos de pago como Nequi y Bancolombia Tokenbox requieren la implementación del SDK. WALLET_CONNECT (MercadoPago) admite los flujos de trabajo SDK y Checkout. Consulta la documentación del SDK para más detalles.
• Seamless SDK: Puedes registrar pago durante el pago sin interrupciones configurando vault_on_success: true al crear el pago. El pago se registrará automáticamente si el pago . Véase Seamless SDK (Pago Web) para más detalles.

Después de crear el cliente, creará una sesión de cliente para identificar y almacenar la información de los clientes con respecto a las preferencias de pago. Usar el endpoint Crear Sesión de Cliente para realizar la solicitud. 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 respuesta del endpoint Crear Sesión de Cliente, recibirás el customer_session. Se utilizará en el proceso de registro del método de pago.

Paso 3: Recuperar métodos de pago para inscribirse

Este es un paso opcional en el que puede enumerar todos los métodos de pago disponibles en los que el cliente puede inscribirse. Si sabe en qué método de pago se inscribirá el usuario, puede continuar con el paso 4.

Para listar los métodos de pago disponibles, puedes utilizar el endpoint Recuperar métodos de pago para inscribirse. Si utilizas el punto final Flujo de trabajo de pago, le informará al customer_session en el pedido. El flujo de trabajo Directo no permite actualmente recuperar los métodos de pago disponibles para inscribirse.

La respuesta al endpoint Recuperar Métodos de Pago para registrarse contendrá solo el payment_methods . Proporcionará una variedad de objetos con todos los métodos de pago disponibles para inscribirse. Usarás el type para inscribir el método de pago en el siguiente paso.

📘

Métodos de pago disponibles

Cuando recuperas los métodos de pago disponibles para registrarse, solo estarán presentes en la respuesta aquellos métodos que hayas conectado, creado una ruta y añadido a tu proceso de pago.

Paso 4: Registra un método de pago

Después de definir el método de pago, puede realizar la inscripción utilizando uno de los endpoints de método de pago de inscripción:

• Flujo de trabajo de pago: Proporcionar el type relacionado con el método de pago elegido para el parámetro payment_method_type. Los tipos admitidos son: CARD, NU_PAY_ENROLLMENT, PAYPAL_ENROLLMENT, DAVIPLATA_ENROLLMENT, WALLET_CONNECT, YAPE_ENROLLMENT, SMART_PIX, ASTROPAY_ENROLLABLE (con espacio), PIX_BIOMETRICO.
• Flujo de trabajo directo: Proporcionar el type relacionado con el método de pago elegido para el parámetro type. (Sólo disponible para CARD métodos de pago para comerciantes que cumplen la normativa PCI)
• Flujo de trabajo SDKmétodos de pago como NEQUI y BANCOLOMBIA_TOKENBOX requieren la implementación del SDK. WALLET_CONNECT (MercadoPago) admite los flujos de trabajo SDK y Checkout.

El usuario debe ser redirigido a la página del proveedor de pago para completar el proceso de inscripción. Recibirá esta URL en el Paso 5.

Paso 5: Recuperar métodos de pago

Para inscribirse con éxito en el método de pago, el cliente debe proporcionar autorización en la página del proveedor de pagos. Para recibir la URL, utiliza uno de los siguientes endpoints dependiendo del flujo de trabajo que estés utilizando:

• Flujo de trabajo de pago: La URL de inscripción se proporciona directamente en la respuesta de inscripción del Paso 4. La URL para redirigir al usuario estará disponible en el parámetro provider.redirect.init_url.
• Direct workflow: para el workflow directo, ya que solo está disponible para inscripciones de tarjetas, recibirá el estado final en el paso anterior.

Redirigir al usuario para que proporcione la autorización necesaria. Después de la inscripción, puede continuar con la creación de la sesión de checkout en el siguiente paso.

Para confirmar la inscripción, puede recuperar los métodos de pago registrados. El status del método de pago inscrito debe ser ENROLLED.

📘

Huella dactilar

Cuando se registra una tarjeta de crédito, también encontrará la fingerprint en la respuesta de la API. Es un campo que representa la tarjeta de su cliente en toda su organización. Cuando un cliente registra una tarjeta de crédito varias veces relacionada con una o varias cuentas de Yuno, se generarán múltiples vaulted_tokens, pero la huella digital le permite identificar cuándo se usa la misma tarjeta en múltiples escenarios.

También encontrará la huella digital en la respuesta de pago cuando se realiza una transacción con una tarjeta de crédito registrada.