Créer des Paiements

Sur cette page, vous trouverez un guide détaillé sur la création d'un paiement et les informations nécessaires pour accomplir une telle tâche.

Prérequis

Avant de commencer à suivre les étapes décrites dans ce guide, vous devez :

Accéder à vos Identifiants API sur le Tableau de Bord Yuno, qui sont composés de :
- public-api-key
- private-secrete-key
- account_id
Configurer vos connexions sur votre compte Tableau de Bord Yuno.
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.

Assurez-vous de remplir ces prérequis avant de suivre le guide de création de paiement.

📘
Explorer les Collections Postman de Yuno
Yuno fournit des Collections Postman que vous pouvez utiliser pour reproduire les cas d'utilisation localement.

Résumé des Étapes

Le processus de création de paiement nécessite normalement de terminer les quatre étapes énumérées ci-dessous.

📘
Méthodes de paiement et fonctionnalités supplémentaires
Différentes méthodes de paiement, telles qu'avec des portefeuilles spécifiques ou le BNPL (Buy Now Pay Later), ou des fonctionnalités, telles que le paiement fractionné, peuvent nécessiter des étapes supplémentaires avant de créer le paiement.

Créer un 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 obligatoires 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. Utilisez cet id pour initialiser la page de paiement.

Si vous créez un 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 de paiement

Avec un client enregistré, vous pouvez créer une session de page de paiement. La page de paiement est le moment où le client finalise sa commande et procède au paiement des produits ou services qu'il souhaite acquérir. Par conséquent, à ce stade, vous fournirez des informations concernant le montant du paiement et l'emplacement où il est créé.

Utilisez l'endpoint Créer une session de paiement . 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.

À partir de la réponse de la requête a l'endpoint Créer une session de paiement , vous recevrez les informations de la checkout_session . Elles seront utilisées pour créer le token à usage unique (OTT) et le paiement aux étapes suivantes.

Étape 3 : Créer un token à usage unique (OTT)

Un token à usage unique est un identifiant unique que Yuno génère pour protéger la confidentialité et la sécurité de votre client. Il sert d'identifiant pour les détails de paiement et empêche les données sensibles d'être stockées sur vos serveurs. Par conséquent, vous pouvez utiliser des jetons à usage unique pour simplifier la répétition des paiements pour vos clients sans qu'ils aient à ressaisir leurs informations de paiement, rendant le processus plus sûr et plus pratique.

Vous obtiendrez toujours le token à usage unique à partir du SDK de Yuno sur votre application. En utilisant le SDK de Yuno, nous prenons en charge chaque scénario particulier que différentes méthodes de paiement pourraient avoir. Cela nous permet de :

Demander des informations manquantes pour la méthode de paiement enregistrée au cas où le fournisseur sélectionné dans la route CARTE aurait besoin de champs supplémentaires.
Prendre en charge le filtrage anti-fraude (Fraud screening)
Prendre en charge le 3DS

Vous pouvez toujours utiliser la liste Types de Paiement pour vérifier tous les types de paiement disponibles. Dans la réponse du SDK, vous recevrez le one-time-token, que vous utiliserez pour créer le paiement.

📘
Tester les Paiements par Carte de Crédit
N'oubliez pas que pour tester les paiements par carte de crédit, vous pouvez définir le uno Test Payment Gateway comme fournisseur dans votre route Carte.

Étape 4 : Créer un paiement

Vous créerez un paiement en utilisant l'endpoint Créer un paiement. Avec Yuno, vous pouvez créer des paiements avec plusieurs méthodes de paiement, en utilisant le 3DS ou le paiement fractionné. Cependant, ce guide se concentre sur un paiement simple sans exigences supplémentaires d'authentification, de validation ou d'enregistrement.

Vous trouverez ci-dessous une description plus détaillée de la façon de créer un paiement.

4.1 Fournir les attributs requis

Fournissez les informations relatives au client, y compris la checkout_session de l'Étape 2 via checkout.session et customer_payer qui contient l' id de l'Étape 1.

Certains objets ne sont pas obligatoires lors de la création d'un paiement. Cependant, si vous fournissez ces informations, l'expérience de paiement de l'utilisateur sera améliorée. Soyez conscient des champs obligatoires si vous souhaitez fournir ces informations.

4.2 Choisir le type de capture

Yuno propose deux options pour la capture de paiement :

Étape unique (Single-step) : L'autorisation et la capture sont effectuées simultanément. Il vous suffit de créer le paiement. L'autorisation et la capture sont effectuées automatiquement. Pour l'option à étape unique, vous devez envoyer l'attribut capture comme true dans la requête.
Deux étapes (Two steps) : L'autorisation et la capture sont effectuées à des moments différents. Après avoir créé le paiement, vous devrez effectuer une requête d'autorisation et une requête de capture. Si vous souhaitez traiter le paiement en Deux Étapes, envoyez capture comme false et après avoir créé le paiement, utilisez Autoriser un Paiement et Capturer une Autorisation pour compléter le processus.

4.3 Fonctionnalités supplémentaires

Yuno vous permet également d'utiliser certaines fonctionnalités supplémentaires prises en charge dans le processus de création de paiement de base :

vault_on_success: Si votre client utilise une carte de crédit pour effectuer le paiement, nous vous permettons d'enregistrer cette méthode de paiement pour le client pour de futurs achats dans la même étape.
installments: Si vous proposez à vos clients des paiements échelonnés et que le processeur que vous avez choisi les accepte, vous pouvez nous envoyer le montant des paiements échelonnés pour créer le paiement.

Les deux champs peuvent être trouvés dans la section payment_method detail du paiement.

ℹ️
Pour générer et recevoir un vaulted_token quand vault_on_success = true, le paiement doit faire référence à un client Yuno existant via customer_payer.idLa création ou l'envoi des données client en ligne dans la demande de paiement ne crée pas le client de notre côté, donc aucun stockage ne se produira. Lorsque ces conditions sont remplies et que le statut du paiement est SUCCEEDED, la fonction vaulted_token sera renvoyé dans la réponse de paiement et pourra être utilisé pour de futures transactions.

Étape 5 : Vérifier le statut du paiement

Après avoir effectué la requête à Créer le Paiement , vous pouvez vérifier le statut du paiement en analysant le status et sub_status de la réponse. Consultez la page Statut de Paiement pour voir toutes les options que vous pouvez recevoir en réponse à la requête de création de paiement.

En fonction du processeur et de la méthode de paiement, le statut peut prendre un certain temps à se mettre à jour. Par conséquent, vous devrez peut-être utiliser l'endpoint pour récupérer le statut du paiement. Pour effectuer cette tâche, vous pouvez utiliser Récupérer le paiement par identifiant ou Récupérer le paiement par identifiant de commande du commerçant. Une autre option consiste à utiliser des webhooks pour recevoir des notifications après chaque événement. Yuno vous recommande d'utiliser des webhooks pour mieux surveiller les paiements asynchrones. Consultez le guide Webhooks pour apprendre à configurer la solution de webhooks fournie par Yuno.

📘
Paiements par Carte de Test
Si vous avez besoin de tester les paiements par Carte en général, Yuno fournit le Yuno Test Payment Gateway. Il fonctionne comme une connexion, cependant, il est disponible uniquement dans l'environnement sandbox. Consultez la page Yuno Test Payment Gateway pour connaître toutes les fonctionnalités, ou allez directement au guide sur la façon de tester les paiements par carte.