Enregistrer des Méthodes de Paiement

Cette page vous guidera dans l'enregistrement d'une méthode de paiement dans un compte client et vous permettra d'obtenir un numéro d'identification de la méthode de paiement. vaulted_token pour les achats futurs.

📘

Token voûté

Un Token voûté est créé une fois qu'une méthode de paiement est enregistrée et stockée avec les informations du client. Vous pouvez utiliser le Token voûté créé pour identifier la méthode de paiement dans les futurs paiements.

Le service de tokenisation et le coffre-fort centralisé de Yuno vous permettent de gérer les paiements récurrents, les fallbacks et les retries entre les processeurs sans compromettre l'UX. Les méthodes de paiement suivantes sont disponibles pour l'inscription à Yuno :

Modes de paiement disponibles pour l'inscription

(*) SDK uniquement. Consultez la documentation du SDK pour plus de détails sur l'intégration.

Prérequis

Avant de commencer le processus d'enregistrement, vous devez :

• Accéder à vos  Identifiants API  sur le Tableau de Bord Yuno, qui sont composés de :
  • public-api-key
  • private-secret-key
  • account_id
• Configurer vos connexions sur votre compte Tableau de Bord Yuno. Ajoutez une méthode de paiement qui nécessite un enregistrement.
• Construire une route pour la méthode de paiement afin de définir comment elle sera traitée.
• Configurer le constructeur de page de paiement pour rendre vos paiements connectés disponibles.

Résumé des Étapes

Pour enregistrer une méthode de paiement dans un compte client, vous suivrez les étapes énumérées ci-dessous.

1. Créer un client
2. Créer une session client (exclusif pour le flux de paiement)
3. (Facultatif) Récupérer les Méthodes de Paiement Disponibles pour l'Enregistrement - flux de paiement
4. Enregistrer la Méthode de Paiement Flux de paiement / Flux Direct
5. Récupérer les Méthodes de Paiement - flux direct

Enregistrer une méthode de paiement

Étape 1 : Créer un client

Utilisez l'endpoint  Créer un client  pour enregistrer les informations du client. Vous devrez fournir des informations personnelles sur le client. De plus, vous devez également fournir le merchant_customer_id, un identifiant unique pour le client utilisé sur votre système.

📘

Informations Complémentaires sur le Client

Lors de la création d'un client, certaines informations ne sont pas requises mais peuvent améliorer l'expérience de paiement de l'utilisateur si elles sont fournies. Le téléphone, l'adresse de facturation et l'adresse de livraison sont des exemples de données non obligatoires que vous pouvez fournir. Si vous ajoutez des informations facultatives, soyez conscient des champs obligatoires requis.

À la fin du processus de création d'un client, vous recevrez un id, qui identifie l'utilisateur dans le système Yuno. Si vous enregistrez une méthode de paiement pour un utilisateur existant, qui a été créé précédemment et qui a déjà un id, vous pouvez ignorer cette étape.

Étape 2 : Créer une session client

🚧

Exigences en matière de flux de travail

Le processus d'inscription varie selon le type de méthode de paiement :

• Processus de paiement: Requiert une session client pour la plupart des méthodes de paiement (cartes, Nupay, PayPal, Daviplata, méthodes dLocal, Astropay, Adyen PIX Biométrico).
• Flux Direct: Disponible uniquement pour les cartes (marchands conformes à la norme PCI). Passez directement à l'étape 3 en utilisant le client id généré à l'Étape 1.
• Flux de travail SDK: Les méthodes de paiement telles que Nequi et Bancolombia Tokenbox nécessitent la mise en œuvre du SDK. WALLET_CONNECT (MercadoPago) prend en charge à la fois le SDK et les flux de paiement. Consultez la documentation du SDK pour plus de détails.
• Seamless SDK: Vous pouvez enregistrer des modes de paiement pendant le processus de paiement fluide en configurant vault_on_success: true lors de la création du paiement. Le mode de paiement sera automatiquement enregistré si le paiement aboutit. Voir Seamless SDK (paiement en ligne) pour plus de détails.

Après avoir créé le client, vous créerez une session client pour identifier et stocker les informations des clients concernant les préférences de paiement. Utilisez l'endpoint  Créer session client  pour effectuer la requête. Notez que le customer_id requis pour effectuer la requête est l' id que vous avez reçu lors de la création du client à  l'Étape 1.

A partir de la réponse du l'endpoint  Créer session client, vous recevrez le customer_session. Elle sera utilisée dans le processus d'enregistrement de la méthode de paiement.

Étape 3 : Récupérer les méthodes de paiement à enregistrer

Ceci est une étape facultative où vous pouvez lister toutes les méthodes de paiement disponibles que le client peut enregistrer. Si vous savez quelle méthode de paiement l'utilisateur enregistrera, vous pouvez passer à l'Étape 4.

Pour lister les méthodes de paiement disponibles, vous pouvez utiliser l'endpoint Retrieve Payment Methods To Enroll. Si vous utilisez le  Processus de paiement , vous informerez le customer_session sur la requête. Le flux Direct ne prend actuellement pas en charge la récupération des méthodes de paiement disponibles à enregistrer.

La réponse au endpoint  Retrieve Payment Methods To Enroll  contiendra uniquement le paramètre payment_methods . Il fournira un tableau d'objets avec toutes les méthodes de paiement disponibles à enregistrer. Vous utiliserez l'information type pour enregistrer la méthode de paiement à l'étape suivante.

📘

Méthodes de Paiement Disponibles

Lorsque vous récupérez les méthodes de paiement disponibles à enregistrer, seules celles que vous avez connectées, créé une route et ajoutées à votre page de paiement seront présentes dans la réponse.

Étape 4 : Enregistrer une méthode de paiement

Après avoir défini la méthode de paiement, vous pouvez effectuer l'enregistrement en utilisant l'un des endpoints Enroll Payment Method :

• Processus de paiement: Fournissez le type lié à la méthode de paiement choisie au paramètre payment_method_type. Les types pris en charge sont les suivants : CARD, NU_PAY_ENROLLMENT, PAYPAL_ENROLLMENT, DAVIPLATA_ENROLLMENT, WALLET_CONNECT, YAPE_ENROLLMENT, SMART_PIX, ASTROPAY_ENROLLABLE (avec espace), PIX_BIOMETRICO.
• Flux Direct: Fournissez le type lié à la méthode de paiement choisie au paramètre type. (Uniquement disponible pour les CARD méthodes de paiement pour les commerçants conformes à la norme PCI)
• Flux de travail du SDK: Modes de paiement tels que NEQUI  et  BANCOLOMBIA_TOKENBOX nécessite la mise en œuvre du SDK. WALLET_CONNECT (MercadoPago) prend en charge les flux de travail du SDK et de la caisse.

L'utilisateur doit être redirigé vers la page du fournisseur de paiement pour terminer le processus d'enregistrement. Vous recevrez cette URL à l'Étape 5.

Étape 5 : Récupérer les méthodes de paiement

Pour enregistrer avec succès la méthode de paiement, le client doit fournir une autorisation sur la page du fournisseur de paiement. Pour recevoir l'URL, utilisez l'un des endpoints suivants en fonction du flux de que vous utilisez :

• Flux de paiement : L'URL d'enregistrement est fournie directement dans la réponse d'enregistrement de l'Étape 4. L'URL pour rediriger l'utilisateur sera disponible dans le paramètre provider.redirect.init_url.
• Flux Direct : Pour le flux de travail Direct, comme il n'est disponible que pour les enregistrements de cartes, vous recevrez le statut final à l'étape précédente.

Redirigez l'utilisateur afin qu'il fournisse l'autorisation requise. Après l'enregistrement, vous pouvez passer à la création de la session de page de paiement à l'étape suivante.

Pour confirmer l'enregistrement, vous pouvez récupérer les méthodes de paiement enregistrées. Le status de la méthode de paiement enregistrée doit être ENROLLED.

📘

Fingerprint

Lorsqu'une carte de crédit est enregistrée, vous trouverez également fingerprint dans la réponse de l'API. C'est un champ qui représente la carte de votre client dans toute votre organisation. Lorsqu'un client enregistre une carte de crédit plusieurs fois liée à un ou plusieurs comptes Yuno, plusieurs vaulted_token seront générés, mais l'empreinte vous permet d'identifier quand la même carte est utilisée dans plusieurs scénarios.

Vous trouverez également l'empreinte dans la réponse du paiement lorsqu'une transaction est effectuée à l'aide d'une carte de crédit enregistrée.