PayPal via Widget

Cette page inclut les étapes nécessaires pour intégrer PayPal en utilisant le Widget DEUNA.

Étapes d'intégration#

Maintenant que les exigences techniques sont définies, vous pouvez démarrer l'intégration.

1. Configurer le processeur de paiement

1. Ajoutez le portefeuille PayPal à votre DEUNA Connexions administratives.
2. Cherchez "PayPal Wallet" et entrez ensuite vos identifiants de compte d'affaires PayPal.

Exemple interactifUtilise des données fictives et n’effectue aucune requête API.

ProductionAgrandir

Paiements

Connexions

Découvrez et gérez les intégrations de paiement, de portefeuille et antifraude.

Acme LATAM · Production

Toutes les connexionsActivesDécouvrir

Rechercher des connexionsEffacer

5 connexions fictivesMis à jour à l’instant

Connexions	Type	Statut	Action
Adyen	Passerelle de paiement	Connectée	Déconnecter
Worldpay	Passerelle de paiement	Connectée	Déconnecter
PayPal	Moyen de paiement	Connectée	Déconnecter
Mercado Pago	Moyen de paiement	Non connectée	Connecter
Riskified	Moteur antifraude	Non connectée	Connecter

2. Créer l'ordre

Pour effectuer un achat, vous devez d'abord créer une commande DEUNA.

Suivez les étapes pour Créer une commande.

L'API retournera un order_token qui est utilisé tout au long du flux.

Champs requis :

Considérations:

• À propos order.items:
  • total_amount.original_amount doit être unit_price.amount * quantity.
  • total_amount.amount doit être ((unit_price.amount + tax_amount.amount) * quantity) - total_amount.total_discount.
  • total_amount.total_discount est la valeur totale des rabais pour la quantité d'articles.
• order.items_total_amount est la somme des prix unitaires des postes, ce montant ajouté au order.total_tax_amount et moins order.discount_amount doit correspondre à la order.total_amount.
• order.sub_total est la somme des éléments du prix unitaire moins les remises, ce montant ajouté à la order.total_tax_amount doit correspondre à order.total_amount.

3. Créer un utilisateur (facultatif)

Créez un utilisateur avec DEUNA afin d'obtenir le jeton d'autorisation pour effectuer l'achat plus tard. Cette API retournera un utilisateur token qui seront nécessaires pour suivre les prochaines étapes.

Pour créer un utilisateur, suivez la Référence API. Si l'email utilisé existe déjà, l'API retournera le message user already exists, pour que vous puissiez procéder à Demande au Bureau du Procureur et puis, Connexion avec le OTP pour obtenir un nouvel utilisateur token et procéder à l'achat.

Paiement Widget#

Le widget DEUNA permet deux processus de paiement pour le widget PayPal dans DEUNA, qui sont documentés dans ce guide. Chaque processus est lancé en fonction des attributs de l'utilisateur qui effectue l'achat.

• Processus express: Compléte le paiement dans les plus brefs délais.
• Processus général: Permet différentes méthodes de paiement.

Expression#

Le flux express est initialisé lorsque le widget détecte une seule expérience de méthode de paiement. Ce flux permet à l'utilisateur de compléter son paiement dans les plus brefs délais.

Une fois que l'utilisateur donne son consentement pour enregistrer son compte PayPal, le paiement est effectué automatiquement et en un seul clic.

Agrandir

Utilisateur nouveau ou invité avec vouting désactivé

Le flux invité est défini pour les nouveaux utilisateurs, les utilisateurs enregistrés qui ne sont pas authentifiés ou lorsque le marchand a désactivé la fonction Vaulting. Dans ce cas, le processus de paiement de la caisse est initialisé, où l'utilisateur entrera dans son compte PayPal pour effectuer le paiement, mais il ne sera pas sauvegardé.

Si l'utilisateur est nouveau, alors leurs données sont enregistrées afin qu'ils puissent s'authentifier pour un achat futur et enregistrer leur compte PayPal pour les paiements futurs.

Agrandir

Utilisateur authentifié sans compte PayPal enregistré

Si l'utilisateur est connecté mais n'a pas de compte PayPal enregistré, alors le processus de paiement voûté est lancé et l'utilisateur est redirigé vers le site PayPal où il effectuera le paiement et donnera son consentement pour enregistrer son compte et l'utiliser pour les achats futurs.

Utilisateur authentifié avec compte PayPal enregistré

Si l'utilisateur a authentifié et a déjà enregistré un compte PayPal, alors le paiement est traité immédiatement parce qu'il a déjà donné son consentement.

Agrandir

Généralités#

Le flux général est activé lorsque le widget détecte une expérience avec plusieurs méthodes de paiement.

L'utilisateur aura un rôle plus important parce qu'il est capable de gérer ses comptes, c'est-à-dire qu'il est capable d'ajouter plusieurs comptes ou de supprimer un compte qu'il n'utilise plus.

Les utilisateurs authentifiés ont également la possibilité de sélectionner des versements selon que le commerçant les exige ou les autorise.

Utilisateur nouveau ou invité avec vouting désactivé

Lorsque l'utilisateur est un utilisateur non authentifié/nouveau ou que le marchand a désactivé la fonction Vaulting:

1. L'utilisateur clique sur le bouton PayPal
2. Le processus de paiement de la caisse commence
3. L'utilisateur doit s'authentifier en PayPal et effectuer le paiement.

Dans ce processus, le compte n'est pas enregistré car il n'y a pas d'identification préalable de l'utilisateur, et leurs données seront déjà enregistrées (s'ils sont nouveaux) de sorte que dans un futur achat ils auront la possibilité de s'authentifier et de donner leur consentement pour enregistrer leur compte PayPal.

Agrandir

Exemple d'achat

Voici un exemple d'un utilisateur qui fait un achat avec PayPal dans DEUNA:

Agrandir

Utilisateur authentifié sans comptes PayPal enregistrés

Lorsque l'utilisateur a authentifié et n'a pas de comptes sauvegardés:

1. Le processus de paiement voûté est lancé et l'utilisateur est redirigé vers PayPal.
2. L'utilisateur effectue le paiement sur le site de PayPal.
3. L'utilisateur donne son consentement pour enregistrer son compte et/ou l'utiliser pour des transactions futures.

Si le commerçant exige des versements, l'utilisateur devra les sélectionner après avoir autorisé le paiement en PayPal.

Utilisateur authentifié avec les comptes PayPal enregistrés

Si l'utilisateur est connecté et a enregistré des comptes PayPal, alors ils peuvent sélectionner n'importe quel compte pour effectuer le paiement. L'utilisateur peut également supprimer n'importe quel compte ou en enregistrer un nouveau.

Si le marchand propose des versements, ceux-ci sont affichés avec le compte sélectionné pour le paiement et si l'utilisateur veut utiliser un nouveau compte PayPal, il devra sélectionner les versements après avoir autorisé le paiement chez PayPal.

Vue sur compte unique

Voici un exemple d'utilisateur avec un seul compte PayPal dans DEUNA :

Agrandir

Vue de plusieurs comptes

Voici un exemple d'utilisateur avec plusieurs comptes PayPal dans DEUNA :

Agrandir

Exemple d'achat

Voici un exemple d'un utilisateur qui fait un achat avec PayPal dans DEUNA:

Agrandir

Transaction PayPal échouée avec Vaulting

Lorsqu'un ordre PayPal est rejeté pendant le flux Vaulting, nous supprimons automatiquement le jeton PayPal associé au compte utilisé dans la tentative ratée.

Cela empêche les transactions futures avec le compte invalide. Juste après, le widget redémarre le processus PayPal afin que l'utilisateur puisse ré-authentifier et lier un nouveau compte PayPal valide pour compléter le paiement.

Agrandir

Montants des remises

Les réductions dans PayPal sont prises en charge au niveau de la commande. Sur la charge utile, vous devez traiter toute réduction discount_amount.