Passerelle de Test Yuno

Pour tester les paiements par Carte en général, Yuno fournit la Passerelle de Test Yuno. Elle fonctionne comme une connexion, mais elle est disponible uniquement dans l'environnement sandbox.

Connexion avec Yuno

Informations Générales

Pays:

Disponible dans tous les pays.

Devises:

Toutes les devises sont disponibles.

Type de cartes:

Crédit, Débit et Prépayé.

Données de test:

Informations de carte pour compléter les paiements en mode test.

Configuration de l'Intégration

Environnement de production

Configurer la Passerelle de Test Yuno

1. Complétez la configuration de l'intégration de la Passerelle de Test.
2. Après avoir établi la connexion, vous devez désigner la Passerelle de Test Yuno comme votre fournisseur de paiement par carte dans votre section de routage. Accédez à Routage sur le tableau de bord Yuno, sélectionnez Non publié, trouvez l'option Carte et cliquez sur Configurer.

3. Créez une nouvelle route pour Carte. Si vous n'êtes pas sûr de la façon de la créer, consultez  Configurer le routage dynamique.
   1. Dans le tableau de bord Routage, ajoutez des conditions pour déclencher le paiement par carte. Vous pouvez utiliser la marque de carte ou le pays comme conditions de déclenchement, par exemple.
   2. Pour la condition créée, ajoutez la Passerelle de Test Yuno.
   3. Pour les options Tous les autres paiements, sélectionnez l'option Annuler. L'image ci-dessous présente un exemple de configuration de routage où la condition de marque de carte a été utilisée, acceptant les paiements avec les marques Visa et Mastercard.

4. Maintenant, vous devez rendre les cartes disponibles pour les tests. Accédez au Checkout builder sur le tableau de bord Yuno. Activez le bouton de basculement pour la carte et publiez la page de paiement en utilisant le bouton Publier.

Utilisez le guide Créer un paiement pour apprendre à tester les paiements par carte.

Tester les Paiements par Carte avec la Passerelle de Test Yuno

Sur cette page, vous trouverez un guide détaillé sur la création d'un paiement par carte à l'aide de la Passerelle de Test Yuno.

La Passerelle de Test Yuno est une solution Yuno pour tester les paiements par carte en général. Elle fonctionne comme une connexion. Cependant, elle est disponible uniquement dans l'environnement Sandbox.

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-secret-key
  • account_id
• Configurer la connexion Passerelle de Test Yuno sur votre compte Tableau de Bord Yuno. Vous trouverez un guide étape par étape sur sa connexion dans la section Configuration de l'intégration.
• Créez une route pour la Passerelle de Test Yuno afin de la définir comme votre fournisseur de paiement par carte. Vous trouverez un guide étape par étape sur la façon de le faire dans la section Configurer la Passerelle de Test Yuno.
• Configurez le checkout builder pour rendre la Passerelle de Test Yuno disponible.

Résumé des Étapes

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

1. Créer un client
2. Créer une Session de Paiement
3. Créer un Token à Usage Unique
4. Créer le paiement

Créer un Paiement

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. 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.

2. Créer une session de page 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éé.

🚧

Filtrage des Conditions de Route

Lors de la création de la route, vous pouvez définir des conditions qui fonctionnent comme des filtres. Si vous avez utilisé le pays comme condition, vérifiez si le pays fourni lors de la création de la session de page de paiement est dans la liste des conditions. Sinon, le paiement par carte pourrait ne pas être traité par la Passerelle de Test Yuno.

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.

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 les tokens à 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 à usgae unique à partir du SDK de Yuno sur votre application de production. Cependant, pour vous faciliter le test du processus de création de paiement, Yuno fournit l'endpoint  Créer un token à usage unique . Vous devrez fournir la checkout_session reçue à  l'Étape 2  et définir le type de paiement comme CARD via le paramètre type . Dans la réponse, vous recevrez le one-time-token, que vous utiliserez pour créer le paiement.

4. Créer un paiement

Vous créerez un paiement en utilisant le endpoint Créer un paiement. 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 Définir le processus de paiement

Lors de la création du paiement, vous devez informer quelle intégration de Yuno vous utilisez. Lorsque vous créez un paiement, vous devez l'informer via l'attribut workflow , qui peut être :

• CHECKOUT: Si vous utilisez le SDK de Yuno pour créer le paiement.
• DIRECT: Si vous utilisez une intégration back-to-back. Pour utiliser ce flux de travail, vous devez être conforme à la norme PCI.
• REDIRECT: Si vous utilisez une intégration back-to-back et une redirection du fournisseur.

4.4 Fournir les informations de la méthode de paiement

Informez les informations de la méthode de paiement via l'objet payment_method. Ici, vous fournirez le one-time-token via l'attribut token et sélectionnerez le type de paiement égal à CARD, celui informé à  l'Étape 3 , basé sur la  Liste des types de paiement . De plus, vous devez ajouter les informations de la carte sur l'objet detail.card.

Vous pouvez utiliser la description du paiement ou des données de carte spécifiques pour obtenir le résultat souhaité lorsque vous testez le paiement avec la Passerelle de Test Yuno. Les sections suivantes décrivent en détail chaque approche.

📘

Processus du système Yuno

Le système Yuno suit un processus séquentiel, examinant initialement les données de la carte et évaluant ensuite la description fournie. Par conséquent, s'il y a une disparité dans le statut indiqué par les données de la carte et la description pour un paiement de test, Yuno priorisera et reflétera le statut associé aux données de la carte.

4.4.1 - Description du paiement

Pour obtenir le résultat de paiement souhaité en utilisant la description du paiement, vous devez définir le résultat attendu comme la description du paiement que vous créez. Par exemple, si vous testez un paiement et attendez un résultat réussi, la description du paiement doit être "SUCCÈS". Vous trouverez toutes les options disponibles dans la section Codes de transaction.

4.4.2 - Détail de la carte

Une autre option pour obtenir les résultats de paiement attendus est d'utiliser l'une des cartes de test fournies par Yuno. Dans les tableaux ci-dessous, vous trouverez une liste de cartes et leurs détails de données à utiliser lors de l'utilisation de la Passerelle de Test Yuno. La colonne Code de Réponse de Transaction définit le statut de paiement renvoyé lorsque vous utilisez la carte correspondante.

4.4.3 - Cartes de test 3DS

Utilisez ces cartes et codes OTP pour tester les flux 3DS via notre environnement de prévisualisation en utilisant un Simulateur Netcetera Demo Merchant (NDM), qui est configuré pour simuler un Serveur de Répertoire et/ou un ACS avec des schémas prédéfinis et des numéros de carte de test. Il n'atteint pas les DS/ACS de test externes, il aide seulement à compléter les flux 3DS à des fins de test.

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.

Selon le processeur et la méthode de paiement, le statut peut prendre un certain temps à se mettre à jour. Par conséquent, vous pourriez avoir besoin d'utiliser des points de terminaison pour récupérer le statut du paiement. Pour effectuer cette tâche, vous pouvez utiliser les endpoints Retrieve Payment by ID ou Retrieve Payment by merchant_order_id. 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 savoir comment configurer la solution webhooks fournie par Yuno.