Full SDK

Avec le Full SDK de Yuno, vous pouvez intégrer Yuno de manière transparente dans votre système. Cette approche simplifie l'intégration, la maintenance et les opérations sans nécessiter de travail de conformité supplémentaire.

Fonctionnalités Clés

  • Expérience utilisateur: Yuno gère l'intégralité du processus de paiement.
  • Personnalisation: Configurez les méthodes de paiement et les éléments d'interface utilisateur (UI) directement depuis le tableau de bord de Yuno.
  • Flexibilité: Ajoutez de nouvelles méthodes de paiement et fonctionnalités sans développement supplémentaire.
  • Intégration unique: Supportez plusieurs méthodes de paiement via une seule implémentation, quelle que soit la méthode choisie par le client.

Ce que vous pouvez faire avec le full SDK

  1. Traiter les paiements de manière fluide.
  2. Inscrire une carte de crédit lors du traitement d'un paiement.
  3. Utiliser un token stocké (vaulted token) provenant d'une méthode de paiement enregistrée.

Suivez les guides étape par étape ci-dessous pour intégrer le Full SDK :

Flux de Paiement

Le Full SDK offre une expérience de paiement unifiée, permettant aux clients de finaliser des transactions en utilisant plusieurs méthodes de paiement au sein d'une seule intégration. Le diagramme ci-dessous illustre le processus complet :

Flux d'intégration Full SDK

Flux d'intégration Full SDK

Ce diagramme illustre le flux d'intégration complet pour le Full SDK, détaillant les interactions entre le Client Marchand, le Serveur Marchand, le Serveur Yuno et le SDK Yuno. Il couvre l'ensemble du parcours de paiement, depuis le lancement d'une commande jusqu'à l'affichage du résultat final du paiement.

Client marchand

Le Client Marchand représente votre application frontend qui interagit à la fois avec votre serveur backend et le SDK Yuno. Il gère les aspects du flux de paiement visibles par l'utilisateur, notamment :

  • Initialiser le paiement
  • Initialiser SDK avec la session de paiement
  • Recevoir un token à usage unique
  • Initialiser le paiement
  • Initialiser SDK pour poursuivre le flux de paiement
  • Afficher l'écran pour que l'utilisateur finalise le paiement
  • Afficher le résultat du paiement (facultatif)

Serveur marchand

Le Serveur Marchand représente votre application backend qui gère les opérations côté serveur et communique avec les serveurs de Yuno. Ses responsabilités clés incluent :

  • Créer un client
  • Créer une session de paiement
  • Créer un paiement
  • Recevoir le résultat du paiement via webhook

Serveur Yuno

Le Serveur Yuno gère toutes les opérations backend liées à la gestion des clients, aux sessions de paiement et au traitement des paiements. Ses principales responsabilités comprennent :

  • Créer un Client
  • Créer une session de paiement
  • Crée un paiement chez le prestataire de paiement
  • Recevoir les résultats du paiement du prestataire de paiement

SDK Yuno

Le SDK Yuno gère l'interface utilisateur et le flux de paiement côté client, gérant la sélection des méthodes de paiement, la génération de tokens et la finalisation du paiement. Ses responsabilités clés comprennent :

  • Recevoir une session de paiement
  • Lister les méthodes de paiement
  • L'utilisateur sélectionne les méthodes de paiement
  • Rappel avec le token usage unique
  • Continuer le flux de paiement
  • Afficher l'écran pour que l'utilisateur finalise le paiement
  • Afficher le résultat du paiement (facultatif)

Flux

Les étapes suivantes décrivent le flux d'interaction complet entre tous les composants de l'intégration du Full SDK , en détaillant la manière dont chaque requête et chaque réponse se déplacent dans le système :

  1. Serveur marchand : Créer un client --> Serveur Yuno : Crée un client
  2. Client marchand : Initier le paiement --> Serveur du commerçant : Créer une session de paiement
  3. Serveur marchand : Créer une session de paiement --> Serveur Yuno : Création d'une session de paiement
  4. Client marchand : Initier le paiement --> Initier le SDK pour poursuivre le flux de paiement
  5. Client marchand : Initier le SDK à poursuivre le flux de paiement --> Yuno SDK : Recevoir la session de paiement
  6. Yuno SDK : Recevoir la session de paiement --> Lister les méthodes de paiement
  7. Yuno SDK : Lister les méthodes de paiement --> L'utilisateur sélectionne les méthodes de paiement
  8. Yuno SDK : L'utilisateur sélectionne les méthodes de paiement --> Rappel avec le token à usage unique
  9. Yuno SDK : Rappel avec le token à usage unique --> Merchant Client : Recevoir token à usage unique
  10. Client marchand : Recevoir un token à usage unique --> Initialiser paiement
  11. Client marchand : Initier le paiement --> Initier le SDK pour poursuivre le flux de paiement
  12. Client marchand : Initialiser le SDK pour poursuivre le flux de paiement --> Yuno SDK : Poursuivre le flux de paiement
  13. Yuno SDK : Poursuivre le flux de paiement --> Afficher l'écran pour que l'utilisateur finalise le paiement
  14. Yuno SDK : Afficher l'écran pour que l'utilisateur finalise le paiement --> Afficher le résultat du paiement (facultatif)
  15. Client marchand : Initialiser le paiement --> Serveur du commerçant : Créer le paiement
  16. Serveur marchand : Créer un paiement --> Serveur Yuno : Crée le paiement chez le prestataire de paiement

Configuration du SDK spécifique à la plateforme

Pour implémenter l'intégration Full SDK, suivez les guides spécifiques à la plateforme ci-dessous :

Flux de paiement utilisant un token stocké

Si un client dispose d'une méthode de paiement enregistrée, il peut utiliser un token stocké  issu du processus d'enregistrement pour effectuer des transactions sans avoir à saisir à nouveau les détails du paiement.

Diagramme Complet du Token Stocké

Ce diagramme illustre le processus de gestion des tokens stockés dans le flux de paiement complet, montrant les interactions entre le Client Marchand, le Serveur Marchand, le Serveur Yuno et le SDK Yuno. Il se concentre sur l'utilisation d'informations d'identification de paiement pré-enregistrées pour des transactions simplifiées.

Client marchand

Le client marchand représente l'application frontale qui interagit avec les clients. Il assume les principales responsabilités suivantes :

  • Initialiser le paiement
  • Initialiser SDK avec la session de paiement
  • Initialiser le paiement
  • Afficher le résultat du paiement

Serveur marchand

Le serveur marchand gère les opérations de base et communique avec le client et les services de Yuno. Ses principales responsabilités sont les suivantes :

  • Créer un client
  • Créer un paiement
  • Recevoir le résultat du paiement

Serveur Yuno

Le serveur Yuno s'occupe de la fonctionnalité principale de traitement des paiements et gère les données des clients. Ses principales responsabilités sont les suivantes :

  • Créer un client
  • Crée un paiement chez le prestataire de paiement
  • Fournit le résultat du paiement

SDK Yuno

Le SDK Yuno gère l'interface utilisateur et le processus de sélection des méthodes de paiement. Ses principales responsabilités sont les suivantes :

  • Recevoir une session de paiement
  • Lister les méthodes de paiement
  • L'utilisateur sélectionne les méthodes de paiement
  • Rappel avec le token usage unique

Flux :

Les étapes suivantes décrivent la séquence détaillée des interactions entre les différents composants du processus de paiement par token stocké :

  1. Client marchand : Initialiser le paiement --> Serveur du commerçant : Créer un client
  2. Serveur marchand : Créer un client --> Serveur Yuno : Créer un client
  3. Client marchand : Initialiser SDK avec la session de paiement --> Yuno SDK : Recevoir la session de paiement
  4. Yuno SDK : Recevoir la session de paiement --> Lister les méthodes de paiement
  5. Yuno SDK : Lister les méthodes de paiement --> L'utilisateur sélectionne les méthodes de paiement
  6. Yuno SDK : L'utilisateur sélectionne la méthode de paiement --> Rappel avec le token à usage unique
  7. Yuno SDK : Rappel avec le token usage unique --> Client marchand : Initialiser le paiement
  8. Client marchand : Initialiser le paiement --> Serveur du commerçant : Créer le paiement
  9. Serveur marchand : Créer un paiement --> Serveur Yuno : Crée le paiement chez le prestataire de paiement
  10. Merchant Client : Afficher le résultat du paiement --> Serveur du commerçant : Recevoir le résultat du paiement
  11. Serveur marchand : Recevoir le résultat du paiement --> Serveur Yuno : Fournit le résultat du paiement

Inscrire une carte de crédit lors du paiement

Avec le Full SDK, vous pouvez sauvegarder les cartes de crédit/débit pour de futurs achats avec la même requête de paiement, sans avoir besoin d'une intégration d'enregistrement séparée. Vous pouvez obtenir le token stocké de deux manières :

  • Via API: Définissez  vault_on_success = true lors de l'utilisation du endpoint  Créer un paiement . Vous recevrez le vaulted_token correspondant à la carte utilisée par le client payeur dans la réponse.
  • Via les paramètres du SDK: Définissez  cardSaveEnable = true dans les fonctionnalités complémentaires du SDK (Web, iOSet  Android). Le SDK affichera une case à cocher pour que les utilisateurs puissent choisir de sauvegarder la carte pour de futurs achats. Si l'utilisateur coche la case, vous recevrez le vaulted_token.
📘

Options d'enregistrement de la carte

Vous ne devez utiliser qu'une seule option pour enregistrer une carte. Pour enregistrer des méthodes de paiement alternatives, vous devez utiliser le Lite SDK.

Après avoir enregistré une méthode de paiement, vous pouvez utiliser le token stocké pour effectuer des paiements. Pour accéder aux informations sur les méthodes de paiement enregistrées par chaque utilisateur, utilisez l'un des endpoints suivants :

🚧

Utilisation d'un token Stocké

Même si l'utilisateur sélectionne une méthode de paiement enregistrée, Yuno recommande d'utiliser le SDK pour tokeniser les informations au lieu d'utiliser directement le token avec l'API de Yuno. Cette approche présente plusieurs avantages :

  • Support 3DS: Sécurité renforcée pour les paiements en ligne.
  • Détection de fraude: Meilleure protection contre les transactions frauduleuses.
  • Collecter les informations requises: Récupérer les champs additionnels requis par le fournisseur si nécessaire.