Via API

Ce guide fournit une procédure étape par étape pour migrer tokens des endpoints de l'API Yuno. En suivant les étapes décrites, vous compilerez une liste de clients avec leurs modes de paiement enregistrés.

Prérequis

Avant de procéder aux étapes de ce guide, assurez-vous que vous avez.. :

• Les trois étapes liées au processus d'importation des cartes depuis un gateway ont été effectuées.
• Accès à votre Identifiants API sur le Dashboard Yuno, qui comprennent :
  • public-api-key
  • private-secret-key
  • account_id

Assurez-vous d'avoir effectué ces étapes et de disposer des données nécessaires avant de poursuivre le guide.

Migrer tokens l'API

Étape 1 : Créer des clients

Pour commencer le processus token , vous utiliserez le endpoint Create Customer endpoint ajouter des clients au système Yuno. Il est important de noter que les modes de paiement ne peuvent pas être enregistrés pour les clients qui n'existent pas dans le système Yuno. Si les clients sont déjà présents dans Yuno, vous pouvez ignorer cette étape.

Pour enregistrer de nouveaux clients, vous devez fournir leurs informations personnelles. En outre, vous devez fournir les merchant_customer_idqui est un identifiant unique du client utilisé dans votre système.

📘

Informations Complémentaires sur le Client

Lors de la création d'un client, certaines informations sont facultatives mais peuvent améliorer l'expérience de payment l'utilisateur si elles sont fournies. Le numéro de téléphone, l'adresse de facturation et l'adresse de livraison sont des exemples de données non obligatoires.

Si vous choisissez d'ajouter des informations facultatives, veillez à ce que tous les champs obligatoires soient également renseignés.

À l'issue de la procédure de création d'un client, vous recevrez un id qui identifie l'utilisateur dans le système Yuno. Utiliser ce id pour enroll les méthodes de payment existantes.

Étape 2 : Vérifier les données du client (facultatif)

Dans cette étape, vous avez la possibilité de vérifier les informations de chaque client enregistré. Utilisez le bouton Récupérer un client endpoint accéder aux données client. Pour ce faire, fournissez le id qui a été généré lors de la création initiale du client.

Étape 3 : Enroll un mode de payment

Pour terminer le processus de migration, vous devez enregistrer les modes de paiement pour chaque client à l'aide des gateway du coffre-fort ou gateway tiers.

Utiliser le Inscrire un Moyen de Paiement endpoint enregistrer les modes de paiement. N'oubliez pas que le customer_id requis pour cette request est le id obtenu lors de la création du client en l'Étape 1. En outre, il convient d'inclure le provider_data objet contenant le token du fournisseur externe, comme indiqué dans l'extrait de code ci-dessous :

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}}" 
}
'

Dans la réponse provenant du endpoint, vous recevrez un vaulted_token qui identifie la méthode de payment inscrite. Il s'agit d'un vaulted_token sera utilisé pour les paiements futurs, ce qui élimine la nécessité de fournir des détails supplémentaires sur la méthode de payment .

Étape 4 : Vérifier le mode de payment inscrit (facultatif)

Une fois le mode de payment enregistré, vous pouvez vérifier que l'enrollment s'est déroulé correctement à l'aide de la fonction récupérer les méthodes de payment enregistrées endpoint. N'oubliez pas que le customer_id nécessaire pour cette request est le id obtenu lors de la création du client en l'Étape 1.