Intégration Flux Direct

Comment ça Marche

Si vous êtes un développeur, vous pouvez utiliser notre Flux Direct pour continuer à utiliser votre page de paiement et vous connecter à nos services en utilisant uniquement une connexion serveur à serveur.

Votre entreprise doit être certifiée PCI pour utiliser notre service de paiement par carte de serveur à serveur. Veuillez transmettre votre certification AOC à votre responsable de compte avant de commencer l'implémentation.

❗️
Nous recommandons toujours d'utiliser les SDK de Yuno plutôt que les intégrations de Flux Direct. Les SDK de Yuno sont conformes à la norme PCI et simplifient le processus de paiement en gérant toutes les complexités, y compris la prévention de la fraude, le 3DS et les exigences spécifiques aux fournisseurs de paiement. Le Flux Direct exige que les marchands gèrent ces aspects manuellement, ce qui augmente la complexité et le risque.

Pour chaque implémentation, nous recommandons de prendre le status et sub_status comme référence principale pour l' état du paiement. Un paiement peut avoir différentes transactions associées, donc en se concentrant sur le statut/sous-statutdu paiement, vous pouvez avoir l'état le plus récent, quel que soit le nombre de transactions effectuées, vous donnant une entrée claire pour la prise de décision. Avec cette intégration, vous pouvez également enregistrer des cartes de crédit pour des achats futurs (également uniquement disponible pour les marchands conformes à la norme PCI).

Paiement

Étape 1 : Créer un client

[Facultatif]: La première étape du flux de paiement est de créer un client. Un client aura des méthodes de paiement associées. Vous pouvez créer un client en utilisant le endpoint suivant. En conséquence, vous recevrez l'ID du client qui a été créé dans la base de données de Yuno.

Vous pouvez ignorer cette étape si vous avez déjà créé le client.

Cette étape est facultative car vous pouvez envoyer les informations client directement dans le paiement sans créer d'objet client dans Yuno.

🚧
La création d'un client est nécessaire si vous souhaitez générer un vaulted_token.

Étape 2 : Créer le paiement

Comme vous gérez l'ensemble de l'expérience de paiement avec cette intégration, vous devrez afficher les méthodes de paiement activées dans votre compte Yuno. Une fois que l'utilisateur a sélectionné la méthode de paiement, vous pouvez créer un paiement. Un paiement rassemble tous les détails cruciaux concernant la commande, les spécificités du client, le montant total, la devise, les produits, les détails d'expédition, et plus encore. Vous pouvez créer un Paiement en utilisant l'endpoint suivant.

Vous pouvez utiliser la section des exemples dans la référence API comme référence. Si l'utilisateur sélectionne une méthode de paiement précédemment enregistrée, vous pouvez utiliser le vaulted_token renvoyé par le service get payment methods pour créer le paiement.

Pendant l'intégration, nous recommandons de prendre le statut et le sous-statut du paiement comme référence principale pour l'état du paiement. Un paiement peut avoir différentes transactions associées, donc en se concentrant sur le statut/sous-statut du paiement, vous pouvez avoir l'état le plus récent, quel que soit le nombre de transactions effectuées, vous donnant une entrée claire pour la prise de décision.

Flux DIRECT vs REDIRECT

Lors de l'utilisation de l'intégration Direct dans Yuno, pour les Méthodes de Paiement Alternatives (PSE, Nequi, MercadoPago, PIX, etc.), vous disposez de deux options de workflow disponibles :

DIRECT: Nous renvoyons la réponse brute des fournisseurs afin que vous puissiez construire l'expérience comme vous le souhaitez avec les données non filtrées.
REDIRECT: Bien que nous renvoyions également la réponse directe des fournisseurs, nous offrons également aux marchands la possibilité d'utiliser un lien de redirection fourni par Yuno où nous gérons l'expérience de paiement juste pour ce paiement. Vous pouvez trouver une telle URL dans le champ payment_method.detail.redirect_url dans la réponse du paiement.

Modules Complémentaires Importants

Webhooks: Nous vous recommandons de configurer les Webhooks dans votre tableau de bord Yuno. Les Webhooks sont le meilleur moyen de garantir que votre système reste à jour avec la progression et le statut du paiement. Étant donné que les notifications d'événements sont déclenchées automatiquement, votre système n'aura pas besoin d'effectuer des requêtes répétées à Yuno.
Empreintes Digitales de l'Appareil: Les empreintes digitales de l'appareil du client sont utilisées à des fins de prévention de la fraude. Elles sont généralement générées en utilisant du JavaScript tiers dans la page de paiement. Si vous utilisez une intégration Direct et que vous souhaitez prendre en charge des fournisseurs de fraude dans le flux de paiement, vous pouvez utiliser cet objet pour spécifier les informations nécessaires. Pour les intégrations utilisant la page de paiement Yuno, la valeur est obtenue automatiquement, donc n'envoyez pas ce champ.
- ```
[...]
"customer_payer": {
    "merchant_customer_id": "1690161049",
    "first_name": "Giovanna",
    "last_name": "Bartell",
    "email": "[email protected]",
     "device_fingerprints": [
        {
            "provider_id": "MERCADO_PAGO",
            "id": "20a6c463-dd0c-4323-9115-03668d178856"
        },
        {
            "provider_id": "CLEARSALE",
            "id": "92d2ea4b-4bf7-494b-aaea-c48276135941"
        }     
  }, 
[...]
```
three_d_secure_setup_id: Utilisez notre JS uniquement pour obtenir le three_d_secure_setup_id , puis gérez le paiement comme une intégration uniquement API. Le flux de travail Direct est uniquement disponible pour les marchands conformes à la norme PCI. Il offre un moyen simple de créer un paiement et de valider les informations de l'utilisateur, obligeant le marchand à n'effectuer qu'une seule requête pour créer le paiement. Pour mettre en œuvre avec succès l'intégration Direct, suivez les étapes décrites dans le guide d'intégration et fournissez les informations requises comme indiqué. Ce service n'est pas nécessaire pour l'implémentation 3DS à l'aide du SDK de Yuno.

Enregistrement

Étape 1 : Créer un client

La première étape du flux de paiement est de créer un client. Un client aura des méthodes de paiement associées. Vous pouvez créer un client en utilisant le endpoint suivant. En conséquence, vous recevrez l'ID du client qui a été créé dans la base de données de Yuno.

Vous pouvez ignorer cette étape si vous avez déjà créé le client.

Étape 2 : Enregistrer une méthode de paiement

📘
Intégration Flux Direct
Cette fonctionnalité est uniquement disponible pour l'enregistrement de Cartes pour les commerçants conformes à la norme PCI.

Une fois que vous avez votre client, vous pouvez enregistrer la méthode de paiement en utilisant le endpoint Enregistrer une méthode de paiement . Avec les informations fournies par Yuno après que le client a sélectionné la méthode de paiement à enregistrer, vous pourrez enregistrer ces informations pour de futurs achats en utilisant le vaulted_token qui représente l'objet de méthode de paiement créé.