Headless SDK (Paiement)

Le Headless SDK de Yuno vous donne un contrôle total sur l'UX et l'UI du paiement sans vous obliger à être conforme à la norme PCI. Avec le Headless SDK, vous pouvez effectuer des paiements par carte ou enregistrer des informations de carte dans les comptes de vos clients. Accédez à Headless SDK (Inscription)pour plus d'informations. Cette page couvre l'opération de paiement. Vous pouvez consulter les guides disponibles ci-dessous.

Flux de Paiement

Le diagramme ci-dessous illustre le flux de paiement complet. Chaque étape est expliquée en détail dans les sections suivantes. Pour les détails d'implémentation spécifiques à la plateforme, reportez-vous au guide correspondant :

Web

iOS

Android

Flux de Paiement Headless SDK

Ce diagramme illustre le processus de paiement headless utilisant le SDK, détaillant les interactions entre le Client Marchand, le Serveur Marchand, le Serveur Yuno et le SDK Yuno. Il décrit les étapes, de l'initialisation du paiement et de la demande de méthodes de paiement à la création et à la réception du résultat 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
Lister les méthodes de paiement
L'utilisateur sélectionne les méthodes de paiement
Initialiser SDK avec la session de paiement et la méthode de paiement
token Gets (usage unique)
Initialiser le paiement

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
Demander les méthodes de paiement disponibles
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
Retourne la méthode de paiement disponible
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 :

Réception de la session de paiement et de la méthode de paiement choisie par l'utilisateur
Rappel avec le token usage unique

Flux

Les étapes suivantes décrivent le flux d'interaction complet entre tous les composants de l'intégration du Paiement Headless SDK, détaillant comment chaque requête et réponse circule dans le système :

Serveur marchand : Créer un client --> Serveur Yuno : Crée un client
Client marchand : Initialiser le paiement --> Serveur du commerçant : Créer une session de paiement
Serveur marchand : Créer une session de paiement --> Serveur Yuno : Créer une session de paiement
Client marchand : Lister les méthodes de paiement --> Serveur du commerçant : Demander la méthode de paiement disponible
Serveur marchand : Demander la méthode de paiement disponible --> Serveur Yuno : Retourne la méthode de paiement disponible
Client marchand : Lister les méthodes de paiement --> Client marchand : L'utilisateur sélectionne les méthodes de paiement
Client marchand : L'utilisateur sélectionne les méthodes de paiement --> Client marchand : Initialiser SDK avec la session de paiement et la méthode de paiement
Client marchand : Initier le SDK avec la session de paiement et la méthode de paiement --> Yuno SDK : Recevoir la session de paiement et la méthode de paiement sélectionnée par l'utilisateur.
Yuno SDK : Réception de la session de paiement et de la méthode de paiement sélectionnée par l'utilisateur --> Yuno SDK : Rappel avec le token usage unique
Yuno SDK : Rappel avec le token à usage unique --> Merchant Client : Obtenir le token (à usage unique)
Client marchand : Obtenir le token (usage unique) --> Client marchand : Initialiser le paiement
Client marchand : Initialiser le paiement --> Serveur du commerçant : Créer le paiement
Serveur marchand : Créer un paiement --> Serveur Yuno : Crée le paiement chez le prestataire de paiement
Serveur du commerçant : Recevoir le résultat du paiement via webhook --> Serveur Yuno : Recevoir les résultats de paiement du prestataire de paiement

📘
Choisissez votre intégration
Le Headless SDK est conçu pour accepter uniquement les paiements par carte. Si vous avez besoin d'effectuer un paiement en utilisant une autre méthode de paiement, vous devez choisir une autre intégration Yuno :

Full SDK

Lite SDK

Flux Direct

Inscrire une carte de crédit lors du paiement

Avec le Headless SDK, vous pouvez sauvegarder les cartes de crédit/débit pour de futurs achats au sein de la même requête de paiement sans intégration d'enregistrement. Vous pouvez obtenir le token stocké lors de l'exécution de la fonction apiClientPayment.generateToken à Étape 4.

Proposez une case à cocher sur votre checkout pour que les utilisateurs choisissent s'ils veulent enregistrer leur carte pour une utilisation future. Si l'utilisateur sélectionne cette option, définissez payment_method.card.save = true lors de l'appel à apiClientPayment.generateToken . Vous recevrez le vaulted_token dans la réponse de la fonction.

📘
Méthodes de Paiement Alternatives
Pour inscrire d'autres méthodes de paiement, consultez la page Lite SDK (Inscription).

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, vous pouvez utiliser 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.

Pour implémenter cela, envoyez le vaultedToken lors du montage du SDK. Le SDK gérera le reste. Si la méthode de paiement nécessite une étape supplémentaire (comme une vérification 3DS), utilisez la méthode yuno.continuePayment() . Cette méthode gère toutes les redirections nécessaires et fonctionne pour les méthodes de paiement enrôlées et régulières qui nécessitent des actions supplémentaires du client.