Apple Pay

Expérience de paiement

1. Dans les pays où Apple Pay est pris en charge, l'option d'ajouter une carte au portefeuille sur l'appareil du consommateur sera activée. Le consommateur peut ajouter ses détails de paiement ainsi que l'adresse de livraison et de facturation dans l'application.
   

2. Dans une application qui prend en charge Apple Pay, le bouton "Acheter avec Apple Pay" apparaîtra lorsque le consommateur sera prêt à passer à la caisse.

3. Les détails de la carte du consommateur sont visibles et peuvent être modifiés à la demande du consommateur. En outre, le montant total est également affiché. Le consommateur devra utiliser Touch ID pour valider le paiement.

4. Une fois le paiement validé, il sera envoyé via le flux d'achat habituel, afin que nous puissions traiter ce paiement.

Pays & devises

Pays pris en charge

• Australie
• Belgique
• Brésil
• Bulgarie
• Canada
• Chine
• Croatie
• Chypre
• République tchèque
• Danemark
• Estonie
• Finlande
• France
• Allemagne
• Guernesey
• Île Heard et îles McDonald
• Hong Kong
• Irlande
• île de Man
• Italie
• Japon
• Jersey
• Kazakhstan
• Lettonie
• Liechtenstein
• Lituanie
• Malte
• Monaco
• Pays-Bas
• Nouvelle-Zélande
• Norvège
• Pologne
• Portugal
• Roumanie
• Russie
• Saint-Marin
• Singapour
• Slovaquie
• Slovénie
• Espagne
• Suède
• Suisse
• Taïwan
• Ukraine
• Émirats Arabes Unis
• Royaume-Uni
• Îles mineures éloignées des États-Unis
• États-Unis
• Vatican

Devises prises en charge

• Albanian lek (ALL)
• Algerian dinar (DZD)
• Angolan kwanza (AOA)
• Argentine peso (ARS)
• Armenian dram (AMD)
• Aruban florin (AWG)
• Australian dollar (AUD)
• Azerbaijani manat (AZN)
• Bahamian dollar (BSD)
• Bahraini dinar (BHD)
• Bangladeshi taka (BDT)
• Barbados dollar (BBD)
• Belarusian ruble (BYN)
• Belize dollar (BZD)
• Bermudian dollar (BMD)
• Bhutanese ngultrum (BTN)
• Boliviano (BOB)
• Bosnia and Herzegovina convertible mark (BAM)
• Botswana pula (BWP)
• Brazilian real (BRL)
• Brunei dollar (BND)
• Bulgarian lev (BGN)
• Burundian franc (BIF)
• Cambodian riel (KHR)
• Canadian dollar (CAD)
• Cape Verde escudo (CVE)
• Cayman Islands dollar (KYD)
• CFA franc BCEAO (XOF)
• CFA franc BEAC (XAF)
• CFP franc (franc Pacifique) (XPF)
• Chilean peso (CLP)
• Chinese yuan (CNY)
• Colombian peso (COP)
• Comoro franc (KMF)
• Congolese franc (CDF)
• Costa Rican colon (CRC)
• Croatian kuna (HRK)
• Czech koruna (CZK)
• Danish krone (DKK)
• Djiboutian franc (DJF)
• Dominican peso (DOP)
• East Caribbean dollar (XCD)
• Egyptian pound (EGP)
• Eritrean nakfa (ERN)
• Ethiopian birr (ETB)
• Euro (EUR)
• Falkland Islands pound (FKP)
• Fiji dollar (FJD)
• Gambian dalasi (GMD)
• Georgian lari (GEL)
• Ghanaian cedi (GHS)
• Gibraltar pound (GIP)
• Guatemalan quetzal (GTQ)
• Guinean franc (GNF)
• Guyanese dollar (GYD)
• Haitian gourde (HTG)
• Honduran lempira (HNL)
• Hong Kong dollar (HKD)
• Hungarian forint (HUF)
• Icelandic króna (ISK)
• Indian rupee (INR)
• Indonesian rupiah (IDR)
• Iraqi dinar (IQD)
• Israeli new shekel (ILS)
• Jamaican dollar (JMD)
• Japanese yen (JPY)
• Jordanian dinar (JOD)
• Kazakhstani tenge (KZT)
• Kenyan shilling (KES)
• Kuwaiti dinar (KWD)
• Kyrgyzstani som (KGS)
• Lao kip (LAK)
• Lebanese pound (LBP)
• Lesotho loti (LSL)
• Liberian dollar (LRD)
• Libyan dinar (LYD)
• Macanese pataca (MOP)
• Macedonian denar (MKD)
• Malagasy ariary (MGA)
• Malawian kwacha (MWK)
• Malaysian ringgit (MYR)
• Maldivian rufiyaa (MVR)
• Mauritanian ouguiya (MRO)
• Mauritian rupee (MUR)
• Mexican peso (MXN)
• Moldovan leu (MDL)
• Mongolian tugrik (MNT)
• Moroccan dirham (MAD)
• Mozambican metical (MZN)
• Myanmar kyat (MMK)
• Namibian dollar (NAD)
• Nepalese rupee (NPR)
• Netherlands Antillean guilder (ANG)
• New Taiwan dollar (TWD)
• New Zealand dollar (NZD)
• Nicaraguan córdoba (NIO)
• Nigerian naira (NGN)
• Norwegian krone (NOK)
• Omani rial (OMR)
• Pakistani rupee (PKR)
• Panamanian balboa (PAB)
• Papua New Guinean kina (PGK)
• Paraguayan guaraní (PYG)
• Peruvian nuevo sol (PEN)
• Philippine peso (PHP)
• Polish zloty (PLN)
• Pound sterling (GBP)
• Qatari riyal (QAR)
• Romanian new leu (RON)
• Russian ruble (RUB)
• Rwandan franc (RWF)
• Saint Helena pound (SHP)
• Salvadoran Colon (SVC)
• Samoan tala (WST)
• São Tomé and Príncipe dobra (STD)
• Saudi riyal (SAR)
• Serbian dinar (RSD)
• Seychelles rupee (SCR)
• Sierra Leonean leone (SLL)
• Singapore dollar (SGD)
• Solomon Islands dollar (SBD)
• Somali shilling (SOS)
• South African rand (ZAR)
• South Korean won (KRW)
• Sri Lankan rupee (LKR)
• Surinamese dollar (SRD)
• Swazi lilangeni (SZL)
• Swedish krona/kronor (SEK)
• Swiss franc (CHF)
• Tajikistani somoni (TJS)
• Tanzanian shilling (TZS)
• Thai baht (THB)
• Tongan paʻanga (TOP)
• Trinidad and Tobago dollar (TTD)
• Tunisian dinar (TND)
• Turkish lira (TRY)
• Turkmenistani manat (TMT)
• Ugandan shilling (UGX)
• Ukrainian hryvnia (UAH)
• United Arab Emirates dirham (AED)
• United States dollar (USD)
• Uruguayan peso (UYU)
• Uzbekistan som (UZS)
• Vanuatu vatu (VUV)
• Venezuelan bolívar (VEF)
• Vietnamese dong (VND)
• Yemeni rial (YER)
• Zambian kwacha (ZMW)
• Zimbabwe dollar (ZWD)

Intégration

Nous proposons ces méthodes de paiement pour les modes d'intégration suivants. Apprenez dans nos guides dédiés les différences individuelles.

• Hosted Checkout Page
• Intégration mobile/client

Trouvez un aperçu général dans le chapitre "Cinématique".

En fonction du mode d'intégration, des différences s'appliquent :

• Hosted Checkout Page
• Intégration mobile/client

Hosted Checkout Page

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

{
   "order":{
      "amountOfMoney":{
         "currencyCode":"EUR",
         "amount":1000
      }
   },
   "hostedCheckoutSpecificInput":{
      "locale":"en_GB",
      "returnUrl":"https://yourReturnUrl.com"
   },
   "mobilePaymentMethodSpecificInput":{
      "authorizationMode":"FINAL_AUTHORIZATION",
      "paymentProductId":302
   }
}

Intégration mobile/client

En fonction du mode de décryptage, des différences s'appliquent :

• Nous gérons le décryptage
• Vous gérez le décryptage

Nous gérons le décryptage

Ce mode externalise la complexité du décryptage des données de paiement vers notre plateforme. Assurez-vous de créer des certificats et de les télécharger comme décrit dans le chapitre dédié. 

Ajoutez les propriétés suivantes à une requête standard CreatePayment lors de l'envoi des données décryptées à notre plateforme :

{
    "mobilePaymentMethodSpecificInput": {
        "encryptedPaymentData": "xxx",
        "paymentProductId": 302,
        "authorizationMode": "FINAL_AUTHORIZATION",
        "ephemeralKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEYcF+GXB1DjbKLn5PgxVky2QTk53HjfoIXOvE7kH6+lixJKSTv1AuPlAUsBD2Nu2qHFwP50Abeh1onwvmvMYY/g==",
        "publicKeyHash": "uUhU0fJoEJNk11gR8Ptd5Uw+jAnudz24rC2EuVcrZhM="
    },
    "order": {
        "amountOfMoney": {
            "amount": 3000,
            "currencyCode": "EUR"
        }
    }
}

Vous gérez le décryptage

Ce mode vous oblige à décrypter vous-même les données de paiement et à les envoyer à notre plateforme. Cela pourrait avoir un impact sur votre type de conformité PCI. Contactez votre acquéreur pour plus d'informations. 

Vous devez également coder cette solution par vous-même. Cependant, vous pouvez utiliser nos SDK dans deux cas :

1. SDK iOS : Ajouter le bouton Apple Pay à votre application qui ouvre la feuille de paiement Apple Pay. Lisez le tutoriel Apple pour plus d'informations.
2. SDK Serveur : Envoyer les données de paiement décryptées à notre plateforme.

Assurez-vous de créer les certificats et de les télécharger sur votre serveur comme décrit dans le chapitre dédié. 

Ajoutez les propriétés suivantes à une requête standard CreatePayment lors de l'envoi des données décryptées à notre plateforme :

{
    "mobilePaymentMethodSpecificInput": {
        "decryptedPaymentData": {
            "dpan": "4761120010000492",
            "cryptogram": "jiSRYgf6G2rjYwAAC0GPAHQAAAA=",
            "expiryDate": "1225",
            "cardholderName": "John Doe",
            "eci": "7"
        },
        "paymentProductId": 302,
        "authorizationMode": "FINAL_AUTHORIZATION"
    },
    "order": {
        "amountOfMoney": {
            "amount": 3000,
            "currencyCode": "EUR"
        }
    }
}

Mapper les propriétés PKPayment à mobilePaymentMethodSpecificInput

Après avoir décrypté le token de paiement sur votre serveur e-commerce, vous devez envoyer ces données via une requête CreatePayment. Comme vous ne pouvez pas utiliser notre SDK iOS pour créer une masse chiffrée, vous devez transmettre ces données via mobilePaymentMethodSpecificInput.decryptedPaymentData. Ce tableau montre comment PKPayment se mappent aux mobilePaymentMethodSpecificInput.decryptedPaymentData.

Selon la requête individuelle, PKPayment peut contenir des informations de commande supplémentaires. Appliquez la cartographie suivante pour les inclure dans votre requête CreatePayment :

Cinématique

En fonction du mode d'intégration et du mode de décryptage, des différences s'appliquent :

• Hosted Checkout Page
• Intégration mobile/client
  • Nous gérons le décryptage
  • Vous gérez le décryptage

Hosted Checkout Page

En fonction des appareils utilisés par vos clients, des différences s'appliquent :

• Avec un appareil Apple
• Avec un ordinateur de bureau et un appareil mobile

Avec un appareil Apple

1. Vos clients finalisent une commande sur leur appareil Apple dans votre boutique et sélectionnent Apple Pay.
2. Vous envoyez cette demande CreateHostedCheckout à notre plateforme.
3. Vous redirigez vos clients via le redirectUrl vers notre Hosted Checkout Page.
4. Vos clients cliquent sur le bouton "Apple Pay" sur le Hosted Checkout Page. Le Hosted Checkout Page ouvre la feuille de paiement.
5. L'appareil Apple ouvre l'application Apple Pay. Vos clients confirment le paiement dans l'application.
6. Nous recevons le résultat de la transaction.
7. Nous redirigeons vos clients vers votre returnURL sur leur appareil Apple.
8. Vous demandez le résultat de la transaction à notre plateforme via GetHostedCheckout ou recevez le résultat via webhooks.
9. Si la transaction a été réussie, vous pouvez livrer les biens/services.

Avec un appareil de bureau et un appareil mobile

Ce flux implique l'interaction entre l'appareil mobile/tablette et l'appareil de bureau de vos clients. L'appareil mobile/tablette doit être un appareil Apple, mais l'appareil de bureau peut être de n'importe quelle marque.

1. Vos clients finalisent une commande sur leur appareil de bureau dans votre boutique et sélectionnent Apple Pay.
2. Vous envoyez cette demande CreateHostedCheckout à notre plateforme.
3. Vous redirigez vos clients sur leur appareil de bureau via le redirectUrl vers notre Hosted Checkout Page.
4. Vos clients cliquent sur le bouton "Apple Pay" sur le Hosted Checkout Page. Un code QR est affiché. Vos clients scannent le code QR affiché avec leur appareil mobile/tablette Apple.
5. L'appareil mobile/tablette Apple ouvre l'application Apple Pay. Vos clients confirment le paiement dans l'application.
6. Nous recevons le résultat de la transaction.
7. Nous redirigeons vos clients vers votre returnURL sur leur appareil de bureau.
8. Vous demandez le résultat de la transaction à notre plateforme via GetHostedCheckout ou recevez le résultat via webhooks.
9. Si la transaction a été réussie, vous pouvez livrer les biens/services.

Intégration mobile/client

Selon que vous laissez la gestion du décryptage des données de paiement à notre charge ou que vous le faites vous-même, des différences s'appliquent :

Nous gérons le décryptage

Assurez-vous de créer les certificats Apple comme décrit ici.

1. Vos clients finalisent une commande dans votre application et sélectionnent Apple Pay.
2. Votre application envoie la demande de commande à votre serveur e-commerce et ouvre la feuille de paiement.
3. Vos clients confirment le paiement dans l'application.
4. Vous envoyez les données de paiement cryptées dans la propriété mobilePaymentMethodSpecificInput.encryptedPaymentdata via cette demande CreatePayment à notre plateforme.
5. Notre plateforme décrypte les données de paiement et les envoie à Apple.
6. Notre plateforme reçoit des données de paiement cryptées de la part d'Apple.
7. Notre plateforme décrypte les données de paiement et les envoie à votre acquéreur pour traiter le paiement.
8. Nous recevons le résultat de la transaction.
9. Vous demandez le résultat de la transaction à notre plateforme via GetPaymentDetails ou recevez le résultat via webhooks.
10. Votre application affiche le résultat de la transaction.
11. Si la transaction a été réussie, vous pouvez livrer les biens/services.

Vous gérez le décryptage 

Assurez-vous de créer les certificats Apple et de configurer votre compte développeur Worldline/Apple comme décrit ici.

1. Vos clients finalisent une commande dans votre application et sélectionnent Apple Pay.
2. Votre application envoie la demande de commande à votre serveur e-commerce et ouvre la feuille de paiement.
3. Vos clients confirment le paiement dans l'application.
4. Votre serveur e-commerce reçoit les données cryptées de la part d'Apple.
5. Votre serveur e-commerce décrypte les données.
6. Vous envoyez les données de paiement décryptées dans les propriétés
   mobilePaymentMethodSpecificInput.decryptedPaymentData
   mobilePaymentMethodSpecificInput.publicKeyHash
   mobilePaymentMethodSpecificInput.ephemeralKey
   via cette demande CreatePayment à notre plateforme.
7. Notre plateforme envoie les données de paiement décryptées à votre acquéreur pour traiter le paiement.
8. Nous recevons le résultat de la transaction.
9. Vous demandez le résultat de la transaction à notre plateforme via GetPaymentDetails ou recevez le résultat via webhooks.
10. Votre application affiche le résultat de la transaction.
11. Si la transaction a été réussie, 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

Proposer ce mode de paiement nécessite que vous enregistriez votre ID Marchand (pour le mode d'intégration Hosted Checkout Page) et/ou que vous créiez vos certificats Apple Pay (pour Intégration mobile/client).

Enregistrez votre ID Marchand (Hosted Checkout Page)

1. Connectez-vous au Merchant Portal. Allez dans Entreprise > Moyens de paiement > Comment accepter des paiements avec Apple Pay > Hosted Checkout Page.
2. Lisez les termes et conditions d'Apple Pay en cliquant sur le lien correspondant. Cochez "J'ai lu et j'accepte les termes et conditions" pour les approuver
3. Cliquez sur "Activer Apple Pay". Vous êtes prêt à proposer Apple Pay à vos clients via le Hosted Checkout Page mode d'intégration

Notez les points suivants : 

• Si vous refusez les termes et conditions d'Apple Pay, la méthode de paiement ne sera pas disponible sur notre Hosted Checkout Page
• Les termes et conditions d'Apple peuvent changer. Tenez-vous informé en y accédant régulièrement

Créer des certificats Apple Pay (Intégration mobile/client)

Pour les paiements via Intégration mobile/client, vous devez créer des certificats Apple. Selon que vous nous laissez gérer le déchiffrement des données de paiement ou vous le faites vous-même, des différences s’appliquent :

Nous gérons le déchiffrement

Cela nécessite de créer des certificats et de les télécharger dans le Back Office. Pour ce faire, suivez ces étapes :

1. Connectez-vous au Merchant Portal. Allez à Entreprise > Moyens de paiement > Comment accepter des paiements avec Apple Pay > SDK mobiles et serveur à serveur
2. Suivez les instructions sur la page pour
   a) Télécharger la demande de signature de certificat (CSR) sur cette page.
   b) Créer le certificat Apple Pay sur le portail développeur Apple en utilisant ce CSR.
   c) Télécharger le certificat généré via le bouton "Télécharger le certificat".

Trouvez des informations détaillées sur la façon d'appliquer ce mode de déchiffrement dans les chapitres “Intégration” et “Cinématique".

Attention aux points suivants : 

• Assurez-vous de créer des certificats distincts pour notre environnement de test et de production.
• Apple vous permet de créer un maximum de trois certificats par ID Marchand. Notez qu'un seul certificat par ID Marchand peut être actif. Utilisez les trois emplacements pour gérer les certificats expirants.
• En raison de cette limitation, nous recommandons d'utiliser un ID Marchand différent pour notre environnement de test et de production.
• Les certificats Apple expirent après deux ans. Assurez-vous de créer et de télécharger un nouveau certificat à temps. Nous vous informerons par e-mail dès qu'un certificat est sur le point d'expirer.

Vous gérez le déchiffrement

Cela nécessite de créer des certificats et de les télécharger sur votre serveur. Pour ce faire, suivez ces étapes :

1. Contactez-nous pour configurer votre compte Worldline pour vous permettre de gérer le déchiffrement par vous-même.
2. Configurez votre compte Développeur Apple pour gérer le jeton Apple Pay par vous-même.
3. Créez les certificats Apple Pay sur le portail développeur Apple
   a) Créer une demande de signature de certificat
   b) Créer un certificat d'identité marchand
   c) Créer un certificat de traitement des paiements
4. Ecrivez le code pour votre application pour le déchiffrement des données.

Trouvez des informations détaillées sur la façon d'appliquer ce mode de déchiffrement dans les chapitres “Intégration” et “Cinématique".

Ce mode de déchiffrement nécessite plus d'efforts de votre part, notamment :

• Déchiffrer le jeton de paiement Apple Pay.
• Génération de clés publiques.
• Création de demandes de signature de certificat (CSR).

Nous recommandons de l’implémenter uniquement si vous :

• Préférez gérer vous-même le chiffrement des données.
• Souhaitez accéder au jeton de paiement avant de traiter le paiement réel.