A través de API

Esta guía proporciona un proceso paso a paso para migrar tokens mediante los puntos finales de la API de Yuno. Siguiendo los pasos descritos, creará una lista de clientes con sus métodos de pago registrados.

Requisitos

Antes de continuar con los pasos de esta guía, asegúrese de tener:

Completados los tres pasos relacionados con el proceso de importación de tarjetas desde una cuenta de gateway .
Has accedido a tu Credenciales de API en el panel de Yuno, que incluye:
- public-api-key
- private-secret-key
- account_id

Asegúrate de haber completado estos pasos y tener los datos necesarios antes de continuar con la guía.

Migrar tokens a través de API

Paso 1: Crear clientes

Para comenzar el proceso de migración de token , utilizarás el endpoint Crear Cliente para añadir clientes al sistema Yuno. Es importante tener en cuenta que no se pueden inscribir métodos de pago para clientes que no existan en el sistema Yuno. Si los clientes ya están presentes en Yuno, puedes saltarte este paso.

Para registrar nuevos clientes, proporcione su información personal. Además, debe proporcionar la merchant_customer_id, que es un identificador único para el cliente utilizado en su sistema.

📘
Información complementaria del cliente
Al crear un cliente, cierta información es opcional, pero si se proporciona, puede mejorar la experiencia de pago del usuario. Algunos ejemplos de datos no obligatorios son el número de teléfono, la dirección de facturación y la dirección de envío.
Si decide agregar información opcional, asegúrese de que también se proporcionen todos los campos obligatorios.

Al completar el proceso de creación de cliente, recibirá un id que identifica al usuario dentro del sistema Yuno. Utiliza esto id para inscribir los métodos de pago existentes.

Paso 2: Verifica los datos del cliente (opcional)

En este paso, tiene la opción de verificar la información de cada cliente registrado. Utiliza el Recuperar Cliente punto final para acceder a los datos del cliente. Para ello, proporcione el id que se generó cuando se creó el cliente inicialmente.

Paso 3: Registra un método de pago

Para completar el proceso de migración, debe registrar los métodos de pago para cada cliente utilizando los datos de la bóveda o puerta de enlace de terceros.

Utilice el Registrar Método de Pago punto final para registrar los métodos de pago. Recuerde, el customer_id Lo requerido para esta solicitud es el id obtenido durante la creación del cliente en Paso 1. Además, incluya el provider_data objeto que contiene el token del proveedor externo, como se muestra en el fragmento de código a continuación:

curl --request POST \
     --url https://api-sandbox.y.uno/v1/customers/{{customer_id}}/payment-methods \
     --header 'X-Idempotency-Key: <Your X-Idempotency-Key>' \
     --header 'accept: application/json' \
     --header 'charset: utf-8' \
     --header 'content-type: application/json' \
     --header 'private-secret-key: <Your private-secret-key>' \
     --header 'public-api-key: <Your public-api-key>' \
     --data '
{
  "country": "BR",
  "type": "CARD",
  "workflow": "DIRECT",
  "provider_data": {
    "id": "MERCADO_PAGO",
    "payment_method_token": "{{provider_card_token}}"
  },
  "account_id": "{{account_id}}" 
}
'

En la respuesta del punto final, recibirá un vaulted_token que identifica el método de pago registrado. Este vaulted_token Se utilizará para pagos futuros, eliminando la necesidad de detalles adicionales del método de pago.

Paso 4: Verifique el método de pago registrado (opcional)

Una vez registrado el método de pago, puede verificar su registro exitoso utilizando el recuperar métodos de pago registrados punto final. Recuerde, el customer_id Lo necesario para esta solicitud es el id obtenido durante la creación del cliente en Paso 1.