Requisitos
Antes de continuar con los pasos de esta guía, asegúrate de haber:- Completado los tres pasos relacionados con el proceso de importación de tarjetas desde una cuenta de gateway.
- Accedido a tus credenciales de API en el Dashboard de Yuno, que incluyen:
public-api-keyprivate-secret-keyaccount_id
Migra tokens mediante la API
Paso 1: Crea clientes
Para comenzar el proceso de migración de tokens, usarás el endpoint Create Customer para agregar clientes al sistema de Yuno. Es importante tener en cuenta que no se pueden inscribir métodos de pago para clientes que no existen en el sistema de Yuno. Si los clientes ya existen en Yuno, puedes omitir este paso. Para registrar nuevos clientes, proporciona su información personal. Además, debes enviar elmerchant_customer_id, que es un identificador único del cliente en tu sistema.
Información complementaria del clienteAl crear un cliente, cierta información es opcional pero puede mejorar la experiencia de pago del usuario si se proporciona. Ejemplos de datos no obligatorios incluyen el número de teléfono, la dirección de facturación y la dirección de envío.Si decides agregar información opcional, asegúrate de proporcionar también todos los campos obligatorios requeridos.
id que identifica al usuario dentro del sistema de Yuno. Usa este id para inscribir los métodos de pago existentes.
Paso 2: Verifica los datos del cliente (opcional)
En este paso, tienes la opción de verificar la información de cada cliente registrado. Usa el endpoint Retrieve Customer para acceder a los datos del cliente. Para ello, proporciona elid que se generó cuando el cliente fue creado inicialmente.
Paso 3: Inscribe un método de pago
Para completar el proceso de migración, debes inscribir métodos de pago para cada cliente usando los datos del vault o gateway de terceros. Utiliza el endpoint Enroll Payment Method para registrar los métodos de pago. Recuerda que elcustomer_id requerido para esta solicitud es el id obtenido durante la creación del cliente en el Paso 1. Además, incluye el objeto provider_data que contiene el token del proveedor externo, como se muestra en el siguiente fragmento de código:
Request
vaulted_token que identifica el método de pago inscrito. Este vaulted_token se usará para pagos futuros, lo que elimina la necesidad de proporcionar datos adicionales del método de pago.
Paso 4: Verifica el método de pago inscrito (opcional)
Una vez inscrito el método de pago, puedes verificar que la inscripción se haya realizado correctamente usando el endpoint retrieve enrolled payment methods. Recuerda que elcustomer_id necesario para esta solicitud es el id obtenido durante la creación del cliente en el Paso 1.