PayPal

Agrandir

Commencez avec PayPal#

Cette page fournit un guide complet pour intégrer Paypal avec DEUNA.

PayPal est une plateforme de paiement numérique reconnue mondialement qui offre aux clients et aux commerçants un moyen sûr et pratique de faire et de recevoir des paiements électroniques.

Comment ça marche#

Il existe deux types de processus de paiement dans PayPal que vous pouvez choisir selon vos besoins:

Départ PayPal

Une expérience de paiement unique qui vous donne plus de contrôle sur l'ensemble du processus de paiement.

• Il offre un flux de caisse simplifié qui maintient les clients locaux à votre site Web pendant le processus d'autorisation de paiement.
• Checkout ne permet pas de stocker le compte PayPal d'un client.
• La vérification n'est effectuée que pour les utilisateurs non authentifiés ou nouveaux et, par conséquent, comme ils n'ont pas d'identité existante, ils n'ont pas encore la possibilité de sélectionner des versements.

Paraît PayPal

Ce flux vous permet de charger le compte à l'avenir sans exiger que le client soit présent lors de la transaction ou de ré-authentifier avec PayPal lorsqu'il est présent lors de la transaction.

• PayPal Vault est disponible uniquement pour les utilisateurs authentifiés.
• Vault a la possibilité de sélectionner les versements.

Exigences#

Le contenu suivant énumère toutes les exigences pour une intégration réussie avec PayPal.

• Environnements:
  • Bac à sable : https://api.sandbox.deuna.io
  • Fabrication : https://api.deuna.io
• Collection Postman :
  https://www.postman.com/deunaonline/workspace/deuna/folder/30572503-42f68d9b-0763-4002-ba5f-7d1168462e59?action=share&source=copy-link&creator=36841419&ctx=documentation

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

2. Payer maintenant Bouton

• Cette option est contrôlée directement dans l'Admin DEUNA, sous les paramètres de la méthode de paiement PayPal de votre marchand.

• Par défaut: CONTINUE — activé par défaut pour tous les marchands (vous n'avez pas besoin de prendre d'action).

• Les marchands peuvent activer "Pay Now" à tout moment directement de l'administrateur, sans avoir besoin d'une nouvelle intégration technique.

• Le changement peut être rétabli chaque fois que nécessaire — ce n'est pas une décision ponctuelle prise pendant l'intégration, mais une basculement des contrôles marchands indépendants.

  Comment choisir la bonne option

• La question clé à poser est : Une fois que l'acheteur approuve le paiement sur PayPal, le montant final est-il déjà verrouillé, sans autre écran de révision sur mon site avant la charge ?

• Si la réponse est oui → utilisez PAY MAINTENANT.

• Si la réponse est non (l'acheteur peut toujours changer d'articles, d'adresse, d'expédition, d'add-ons, ou voir un écran de confirmation final) → utiliser l'option par défaut (vous n'avez pas besoin de prendre d'action).

  Quand utiliser PAYER MAINTENANT

• Recommandé pour les flux transactionnels, où le prix est déjà verrouillé au moment où l'acheteur est redirigé vers PayPal:

  • Achat direct / "Acheter maintenant" sur une page de produit, sans panier ni étape supplémentaire de révision.

  • Billets ou réservations à prix final fixe au moment de la sélection — c'est-à-dire pas de sélection de sièges, de bagages ou de mises à niveau après le retour de PayPal.

  • Abonnements et paiements récurrents avec un montant fixe et immuable.

  • Express / un clic de caisse, où chaque étape supplémentaire augmente l'abandon.

  • Marchandises numériques (apps, jeux, contenu), où l'acheteur s'attend à "payé = livré" instantanément.

    Quand utiliser CONTINUE (par défaut)

  • Recommandé quand il y a encore une étape de confirmation ou de révision sur le site du marchand après le retour de PayPal:

    • Panier multi-item, où l'acheteur peut ajouter des produits, appliquer un coupon, ou de revoir l'expédition avant de confirmer.
    • Flux où l'expédition ou les taxes ne sont calculées qu'après approbation (p. ex., selon l'adresse de livraison).
    • Réservations avec options supplémentaires après approbation, telles que sélection de sièges ou mises à niveau, avant la capture finale.

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

4. Choisissez le type d'intégration

Après avoir créé une commande, choisissez le type d'intégration qui correspond le mieux à vos besoins :

5. Intégrer FraudeNet

Fracknet est une bibliothèque développée par PayPal qui analyse les données envoyées par le navigateur pendant l'ensemble du processus d'achat pour prévenir toute fraude possible dans les transactions effectuées.

Le réseau frauduleux doit être opérationnel tout au long du processus de transaction. Pour son intégration, PayPal fournit la documentation suivante: Intégrer FraudeNet

6. Valider les paiements

Valider les paiements et vous assurer d'utiliser les règles PayPal correctement.

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 remise à travers le discount_amount field.