Saltar al contenido principal
Esta guía ofrece un proceso paso a paso para migrar tokens usando los endpoints de la API de Yuno. Al seguir los pasos descritos, compilarás una lista de clientes con sus métodos de pago inscritos.

Requisitos

Antes de continuar con los pasos de esta guía, asegúrate de haber: Asegúrate de haber completado estos pasos y de contar con los datos necesarios antes de continuar con la guía.

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 el merchant_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.
Al completar el proceso de creación del cliente, recibirás un 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 el id 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 el customer_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
En la respuesta del endpoint, recibirás un 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 el customer_id necesario para esta solicitud es el id obtenido durante la creación del cliente en el Paso 1.