Paypal

Pays & devises

Pays pris en charge

• Afghanistan
• Albanie
• Algérie
• Samoa américaines
• Andorre
• Angola
• Anguilla
• Antigua-et-Barbuda
• Argentine
• Arménie
• Aruba
• Australie
• Autriche
• Azerbaïdjan
• Bahamas
• Bahreïn
• Bangladesh
• Barbade
• Biélorussie
• Belgique
• Belize
• Bénin
• Bermudes
• Bhoutan
• Bolivie
• Bonaire, Saba et Sint Eustatius
• Bosnie-Herzégovine
• Botswana
• Brésil
• Brunei
• Bulgarie
• Burkina Faso
• Burundi
• Cambodge
• Cameroun
• Canada
• Cap-Vert
• Îles Caïmans
• République Centrafricaine
• Tchad
• Chili
• Chine
• Colombie
• Comores
• Congo (République Démocratique)
• Congo (République)
• Îles Cook
• Costa Rica
• Croatie
• Chypre
• République tchèque
• Danemark
• Djibouti
• République dominicaine
• Dominique
• Équateur
• Égypte
• Salvador
• Eswatini
• Guinée équatoriale
• Érythrée
• Estonie
• Éthiopie
• Îles Falkland
• Îles Féroé
• Fidji
• Finlande
• France
• Guyane française
• Polynésie française
• Gabon
• Gambie
• Géorgie
• Allemagne
• Ghana
• Gibraltar
• Grèce
• Groenland
• Grenade
• Guadeloupe
• Guam
• Guatemala
• Guinée
• Haïti
• Honduras
• Hong Kong
• Hongrie
• Islande
• Inde
• Indonésie
• Irak
• Irlande
• Israël
• Italie
• Côte d'Ivoire
• Jamaïque
• Japon
• Jordanie
• Kazakhstan
• Kenya
• Kiribati
• Koweït
• Kirghizistan
• Laos
• Lettonie
• Liban
• Lesotho
• Libéria
• Libye
• Liechtenstein
• Lituanie
• Luxembourg
• Macao
• Macédoine
• Madagascar
• Malawi
• Malaisie
• Maldives
• Mali
• Malte
• Îles Marshall
• Martinique
• Mauritanie
• Maurice
• Mexique
• Micronésie
• Moldavie
• Monaco
• Mongolie
• Monténégro
• Maroc
• Mozambique
• Myanmar
• Namibie
• Nauru
• Népal
• Antilles néerlandaises
• Pays-Bas
• Nouvelle-Calédonie
• Nouvelle-Zélande
• Nicaragua
• Nigeria
• Niger
• Niue
• Île Norfolk
• Îles Mariannes du Nord
• Norvège
• Oman
• Pakistan
• Palaos
• Panama
• Papouasie-Nouvelle-Guinée
• Paraguay
• Pérou
• Philippines
• Pologne
• Portugal
• Porto Rico
• Qatar
• Réunion
• Roumanie
• Russie
• Rwanda
• Sainte-Hélène
• Saint-Kitts-et-Nevis
• Sainte-Lucie
• Saint-Pierre-et-Miquelon
• Saint-Vincent-et-les-Grenadines
• Samoa
• Saint-Marin
• São Tomé-et-Principe
• Arabie Saoudite
• Sénégal
• Serbie
• Seychelles
• Sierra Leone
• Singapour
• Slovaquie
• Slovénie
• Îles Salomon
• Somalie
• Afrique du Sud
• Corée du Sud
• Espagne
• Sri Lanka
• Soudan
• Suriname
• Suède
• Suisse
• Taïwan
• Tadjikistan
• Tanzanie
• Thaïlande
• Togo
• Tonga
• Trinité-et-Tobago
• Tunisie
• Turkménistan
• Îles Turques-et-Caïques
• Tuvalu
• Ouganda
• Ukraine
• Émirats Arabes Unis
• Royaume-Uni
• États-Unis
• Uruguay
• Ouzbékistan
• Vanuatu
• Vatican
• Venezuela
• Vietnam
• Îles Vierges (britanniques)
• Îles Vierges (États-Unis)
• Yémen
• Zambie
• Zimbabwe

Devises prises en charge

• Australian dollar (AUD)
• Brazilian real (BRL)
• Canadian dollar (CAD)
• Czech koruna (CZK)
• Danish krone (DKK)
• Euro (EUR)
• Hong Kong dollar (HKD)
• Hungarian forint (HUF)
• Israeli new shekel (ILS)
• Japanese yen (JPY)
• Malaysian ringgit (MYR)
• Mexican peso (MXN)
• New Taiwan dollar (TWD)
• New Zealand dollar (NZD)
• Norwegian krone (NOK)
• Philippine peso (PHP)
• Polish zloty (PLN)
• Pound sterling (GBP)
• Russian ruble (RUB)
• Singapore dollar (SGD)
• Swedish krona/kronor (SEK)
• Swiss franc (CHF)
• Thai baht (THB)
• United States dollar (USD)

Intégration

Redirigez vos clients vers le portail PayPal via les modes d'intégration Hosted Checkout Page ou Server-to-server. 

L'API PayPal Complete Payments distingue deux modes, vous permettant d'adapter l'expérience de paiement de vos clients selon vos préférences.
Selon la cinématique, des différences s'appliquent :

• PayPal affiché sur la Hosted Checkout Page (anciennement Express Checkout Mark)
• Bouton raccourci PayPal sur la page de checkout du commerçant (anciennement Express Checkout Shortcut)

Vous trouverez une vue d'ensemble de haut niveau dans le chapitre "Cinématique".

PayPal affiché sur la Hosted Checkout Page

Vous collectez l'adresse de livraison de vos clients avant de les rediriger vers la Hosted Checkout Page. Vos clients peuvent choisir entre différentes options de paiement (Buy Now, Pay Later), proposées dynamiquement en fonction de leur éligibilité et de leur pays. Cette cinématique de paiement optimisée est alignée sur les bonnes pratiques UX de PayPal.

Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout :

{
   "hostedCheckoutSpecificInput":{
      "locale":"en_GB"
   },
   "redirectPaymentMethodSpecificInput":{
      "requiresApproval":true,
      "paymentProduct840SpecificInput":{
         "AddressSelectionAtPayPal":false
      }
   },
   "order":{
      "amountOfMoney":{
         "amount":100,
         "currencyCode":"EUR"
      },
      "customer":{
         "contactDetails":{
            "emailAddress":"test@worldline.com"
         }
      },
      "shipping":{
         "address":{
            "street":"Shipping Street",
            "houseNumber":"88",
            "zip":"1930",
            "city":"Brussels",
            "countryCode":"BE",
            "name":{
               "firstName":"ShipFN",
               "surname":"ShipLN"
            }
         },
         "type":"delivery",
         "shippingCost":0,
         "shippingCostTax":0
      }
   }
}

Bouton raccourci PayPal sur la page de checkout du commerçant

Disponible à la fois via la Hosted Checkout Page et en Server-to-server, ce mode vous permet d'afficher un bouton PayPal directement sur la page de checkout de votre boutique en ligne. En cliquant sur ce bouton, vos clients sont redirigés vers le portail PayPal pour gérer leur adresse de livraison et confirmer la commande.

Une intégration en Server-to-server nécessite la mise en œuvre du PayPal JavaScript SDK afin de respecter les directives de PayPal.  

Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout/CreatePayment :

{
   "redirectPaymentMethodSpecificInput":{
      "requiresApproval":true,
      "paymentProductId":840,
      "paymentProduct840SpecificInput":{
         "AddressSelectionAtPayPal":true
      }
   },
   "order":{
      "amountOfMoney":{
         "amount":100,
         "currencyCode":"EUR"
      },
      "customer":{
         "contactDetails":{
            "emailAddress":" YourCustomer@domain.com"
         }
      }
   }
}

Cinématique

Depending on the mode, differences apply:

• PayPal affiché sur la Hosted Checkout Page
• Bouton raccourci PayPal sur la page de checkout du commerçant

PayPal affiché sur la Hosted Checkout Page

1. Vos clients finalisent une commande dans votre boutique et sélectionnent PayPal.
2. Vous envoyez cette requête CreateHostedCheckout (incluant les détails de livraison) à notre plateforme.
3. Vous redirigez vos clients via la redirectUrl vers la Hosted Checkout Page. Ils sélectionnent PayPal et sont redirigés vers le portail PayPal. Ils confirment la commande avec leurs identifiants de connexion (adresse e-mail et mot de passe).
4. Nous recevons le résultat de la transaction.
5. Nous redirigeons votre client vers votre returnUrl.
6. Vous récupérez le résultat de la transaction auprès de notre plateforme via GetHostedCheckout ou recevez le résultat webhooks.
7. Si la transaction a réussi, vous pouvez livrer les biens / services.

Bouton raccourci PayPal sur la page de checkout du commerçant

1. Le bouton PayPal apparaît plus tôt - directement dans la page produit ou dans le panier).
2. Quand l'acheteur clique dessus, vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme.
3. ous redirigez vos clients via la redirectUrl (pour les requêtes CreateHostedCheckout) ou merchantAction.redirectData.redirectURL (pour les requêtes CreatePayment) vers le portail PayPal. Ils sélectionnent leurs détails de livraison et confirment la commande avec leurs identifiants de connexion (adresse e-mail et mot de passe).
4. Nous recevons le résultat de la transaction.
5. Nous redirigeons votre client vers votre returnUrl.
6. Vous récupérez le résultat de la transaction auprès de notre plateforme via GetHostedCheckout / GetPaymentDetails ou recevez le résultat webhooks.
7. Si la transaction a réussi, vous pouvez livrer les biens / services.

Test

Consultez nos Cas de test pour des données de test et des instructions détaillées.

Informations supplémentaires

PayPal Vault (paiements récurrents)

PayPal Vault vous permet de stocker de façon sécurisée le moyen de paiement PayPal de vos clients pour un usage futur : paiements récurrents paiements récurrents ou abonnements.

À l'instar du cadre COF pour les paiements par carte (compte enregistré (Account on file)), vous devez obtenir le consentement explicite de vos clients pour stocker et utiliser les tokens afin de permettre des transactions initiées par le Marchand (MIT –Merchant Initiated Transactions).

Création de token (transaction initiale)

Ajoutez la propriété  redirectPaymentMethodSpecificInput.tokenize=true à votre requête CreateHostedCheckout/CreatePayment request décrite dans le chapitre "Intégration". Si la transaction est réussie, notre plateforme renvoie un token dans la propriété  redirectPaymentMethodSpecificOutput.token.

Token usage (MIT)

Ajoutez la propriété redirectPaymentMethodSpecificInput.token avec la valeur que vous avez reçue dans la réponse au paiement initial.