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

Depending on the integration mode and the decryption mode, differences apply:

• Hosted Checkout Page
• Intégration mobile/client
  • We handle decryption
  • You handle decryption

Hosted Checkout Page

Make sure to register your Merchant ID as described here.

1. Your customers finalise an order in your shop and select Apple Pay.
2. You send this CreateHostedCheckout request to our platform.
3. You redirect your customers via the redirectUrl to the Apple Pay payment sheet. Your customers confirm the payment.
4. Our platform receives encrypted payment data from Apple.
5. Our platform decrypts the payment data and sends it to your acquirer to process the payment.
6. We receive the transaction result.
7. You redirect your customers to your redirectUrl.
8. You request the transaction result from our platform via GetHostedCheckout or receive the result via webhooks.
9. If the transaction was successful, you can deliver the goods/services.

Intégration mobile/client

Depending on whether you leave handling payment data decryption to us or do this by yourself, differences apply:

We handle decryption

Make sure to create Apple certificates as described here.

1. Your customers finalise an order in your app and select Apple Pay.
2. Your app sends the order request to your e-commerce server and opens the payment sheet.
3. Your customers confirm the payment in the app.
4. You send the encrypted payment data in property mobilePaymentMethodSpecificInput.encryptedPaymentdata via this CreatePayment request to our platform.
5. Our platform decrypts the payment data and sends them to Apple.
6. Our platform receives encrypted payment data from Apple.
7. Our platform decrypts the payment data and sends it to your acquirer to process the payment.
8. We receive the transaction result.
9. You request the transaction result from our platform via GetPaymentDetails or receive the result via webhooks.
10. Your app displays the transaction result.
11. If the transaction was successful, you can deliver the goods/services.

You handle decryption 

Make sure to create Apple certificates and configure your Worldline/Apple developer account as described here.

1. Your customers finalise an order in your app and select Apple Pay.
2. Your app sends the order request to your e-commerce server and opens the payment sheet.
3. Your customers confirm the payment in the app.
4. Your e-commerce server receives the encrypted data from Apple.
5. Your e-commerce server decrypts the data.
6. You send the decrypted payment data in properties
   mobilePaymentMethodSpecificInput.decryptedPaymentData
   mobilePaymentMethodSpecificInput.publicKeyHash
   mobilePaymentMethodSpecificInput.ephemeralKey
   via this CreatePayment request to our platform.
7. Our platform sends the decrypted payment data to your acquirer to process the payment.
8. We receive the transaction result.
9. You request the transaction result from our platform via GetPaymentDetails or receive the result via webhooks.
10. Your app displays the transaction result.
11. If the transaction was successful, you can deliver the goods/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.