Comment configurer votre compte ?

Vous devez vous rapprocher de votre responsable de compte bancaire pour obtenir les informations nécessaires permettant de configurer votre moyen de paiement sur Monext.
Ensuite veuillez adresser un email à notre équipe support avec les informations (MarchandID du compte Apple Pay et la liste des contrats VAD associés) , afin qu'ils puissent procéder au paramétrage dans votre compte marchand Monext en indiquant l’ID Marchand et le nom de l’alias du contrat partenaire à créer.
Vous devez réaliser des transactions 'pilote' pour valider le bon fonctionnement en production.

Dans le Centre administration de Monext, lors de la création du moyen de paiement, les champs à configurer sont les numéros de contrats Visa, Mastercard, Discover.

Le code (card_code) du moyen de paiement est : APPLE_PAY

Image Added

Gestion des certificats

Lors de la création veuillez consulter la gestion des certificats ici.

Les options

• Vous pourrez sélectionner les options d'affichages du type du bouton et du style du bouton Apple Pay ;
• Configurez l'affichage d’Apple Pay afin qu'il soit systématiquement en première position si l'acheteur a déjà utilisé Apple Pay.

Réseau CB 

Le moyen de paiement vous permet de traiter les transactions de cartes bancaire CB sur le réseau CB  simplement

• en configurant votre moyen de paiement : paramètre Carte Bancaire ci-dessus.
• en alimentant la valeur du service de paiement : card.PaymentData.Network = cartesBancaires
  

Pour les autres réseaux 

• VISA = visa
• MASTERCARD = masterCard
• CB = cartesBancaires

Voir documentation Apple :https://developer.apple.com/

Configuer l'EDI XCode d'Apple

Lorsque vous ouvrez un projet, il faut paramétrer le marchandID. Cet identifiant sera fourni par Monext.

Comment proposer ApplePay à vos clients ?

Ce moyen de paiement est disponible avec l'API WebPayment (mode Widget uniquement) et l'API DirectPayment.

Deux intégrations possibles

• En App native : le commerçant récupère les info d’ApplePay et il réalise un doAuthorization depuis son SI avec les informations d’ApplePay. Le commerçant peut également décrypter le PaymentData d'ApplePay et réaliser la demande de paiement à Monext avec la carte bancaire. 
• En Web/App avec webview : le commerçant réalise un doWebPayment sur un contrat ApplePay de Monext. Le consommateur utilise son Iphone, Ipad, ou un Mac avec un TouchID intégré (ou un Mac avec son Iphone à côté du Mac: Safari se charge de faire le lien).
  
  

Les étapes sont les suivantes

1. Le commerçant doit activer le moyen de paiement sur centre administration Monext.

Sur AppMobile (mode API DirectPayment) avec le certificat géré par Monext

Lorsque vous sélectionnez l'option 2 dans la création du moyen de paiement : Apple Pay - Création des éléments sur Monext Online et Apple Pay

2. Création d'une application mobile enregistrée dans l'AppleStore pour permettre aux consommateurs de sélectionner les produits et/ou services ;

3. L'application mobile doit proposer le bouton ApplePay et la page de paiement avec le TouchID en intégrant le PassKit du SDK d'ApplePay avec les serivces canMakePayments et ApplePaySession ;

4. Le commerçant utilise le service prepareSession pour créer la session de paiement côté ApplePay à partir du certificat idendity Monext.

• • Monext appelle le service MerchantValidation d'Apple Pay : pour validez l'identité marchand et recevoir un objet de session pour chaque demande de paiement.
  • Le commerçant transmet les paymentTokenData en retour de Monext vers le javascript d’ApplePay.
    • https://developer.apple.com/documentation/apple_pay_on_the_web/apple_pay_js_api/providing_merchant_validation
  • Ensuite, lors du paiement de l’acheteur, le marchand récupère les données de paiement chiffrées en provenance d’Apple Pay.
  • Le commerçant peut transmettre ces données à Monext via le service doAuthorization.

5. Monext décrypte le PaymentData et réalise la transaction puis retourne le résultat au serveur commerçant en temps réel ;

6. Le serveur commerçant informe l'application mobile qui affiche le résultat de l'opération.

{
   "displayName:"MyStore",
   domainName:"mystore.example.com",
   validationURL:"https://apple-pay-gateway.apple.com/paymentservices/paymentSession""
}

{
    "epochTimestamp": 1665645679253,
    "expiresAt": 166564564569253,
    "merchantSessionIdentifier": "SSH690EA65CBF4568E40D09BA7CD.............",
    "nonce": "7dc980d2",
    "merchantIdentifier": "378E33CF6B48CA390B0D4572820597456ED66F4844C1307CAFCCF7F7B9",
    "domainName": "webpayment.dev.payline.com",
    "displayName": "Demo_REST",
    "signature": "308006092a6587416f70d010.................",
    "operationalAnalyticsIdentifier": "DEMO_REST:378E336B48CA39...........",
    "retries": 0,
    "pspId": "378E38CA390.........."
}

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:impl="http://impl.ws.payline.experian.com">
   <soapenv:Header/>
   <soapenv:Body>
      <impl:prepareSessionRequest>
         <impl:version>22</impl:version>
         <impl:contractNumber>ApplePayTest08S</impl:contractNumber>
         <impl:orderRef>ODERrEF2222</impl:orderRef>
         <impl:miscData>{ "ApplePayTest08S" : "{\"displayName\":\"nameToDisply\",\"domainName\":\"webpayment.dev.payline.com\",
\"validationURL\":\"https:\/\/apple-pay-gateway-cert.apple.com\/paymentservices\/startSession\"}"}</impl:miscData>
      </impl:prepareSessionRequest>
   </soapenv:Body>
</soapenv:Envelope>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header/>
   <soapenv:Body>
      <impl:prepareSessionResponse xmlns:impl="http://impl.ws.payline.experian.com" xmlns:obj="http://obj.ws.payline.experian.com">
         <impl:result>
            <obj:code>00000</obj:code>
            <obj:shortMessage>ACCEPTED</obj:shortMessage>
            <obj:longMessage>Transaction approved</obj:longMessage>
         </impl:result>
         <impl:data>{"epochTimestamp":1675935416164,"expiresAt":1675939016164,"merchantSessionIdentifier":"SSHDE262B37C6824EA9A07290DE5A943F0F94927C24",
"nonce":"746ed113","merchantIdentifier":"73630A6EC0599D8245A8DD657A0B","domainName":"webpayment.dev.payline.com",
"displayName":"nameToDisply","signature":"3080060928648ce..d079cfaa000000000000",
"operationalAnalyticsIdentifier":"nameToDisply:73630A6EC059E2915DD82D8245A8DD657A0B","retries":0,"pspId":"B480C6D24121D1C2C5FFFF37B6"}                 
</impl:data>
      </impl:prepareSessionResponse>
   </soapenv:Body>
</soapenv:Envelope>

Qu'est-ce que ApplePay?

Avec ApplePay, les commerçants profitent d'une solution de paiement cross-canal in-App & in-Store et d'une sécurité de paiement avec le système d'empreinte digitale sur les appareils Apple.
La technologie Touch ID est l’équivalent du 3D-Secure avec transfert de responsabilité pour les transactions frauduleuses.
Les cartes bancaires supportées sont : Visa, Mastercard, American Express et Discover.

ApplePay fonctionne avec les applications mobiles et les pages web.
Pour les commerçants exploitant une page web, il suffit d'intégrer la librairie ApplePay.js et le consommateur doit utiliser le navigateur Safari.
Pour réaliser les paiements ApplePay sur Mac (version 2012 ou supérieure et avec MacOS Sierra), le consommateur devra confirmer le paiement avec iPhone 6 ou supérieur ou Apple Watch.
A ce jour, les appareils supportés sont : iPhone 7, iPhone 6, iPhone 6 Plus, iPhone 6S, iPhone 6S Plus, Apple Watch, iPad Air 2 et iPad mini. Ils doivent néanmoins supporter la technologie du « Touch-ID » avec iOS 10.

Les fonctions disponibles

En synthèse, ce moyen de paiement :

• permet d'être utilisé comme un portefeuille électronique, les cartes de paiement sont enregistrées sur l’appareil de manière sécurisée;
• permet de réaliser des paiements à la commande ou à l'expédition de la commande ;
• permet au commerçant d'utiliser les fonctions de paiement Abonnement,  Annulation, Remboursement et de manière total, partiel ou multiple;
• permet de réaliser des paiements récurrents  ;
• est disponible avec l'API Direct de Payline ;
• est multidevise ;

Lien vers le site web  : https://www.apple.com/apple-pay/

Traitement Synchrone/Asynchrone

Le traitement du paiement est réalisé en mode synchrone. Le commerçant reçoit la réponse en temps réel.

Quel est le parcours utilisateur avec ApplePay ? 

Intégration App Mobile

L'expérience utilisateur d'un paiement se résume aux étapes suivantes :

Image Removed

Intégration Web Mobile

L'expérience utilisateur d'un paiement se résume aux étapes suivantes :

1. L'acheteur valide sa commande sur le navigateur du marchand. Le web marchand propose le moyen de paiement ApplePay à l'acheteur et l'acheteur sélectionne le moyen de paiement ApplePay;
2. L'acheteur confirme le paiement avec le touchID ;
3. L'acheteur reçoit sa confirmation de paiement.

Image Removed

Quel est le reporting disponible ?

Les transactions ApplePay apparaissent dans le backoffice Payline en temps réel et dans les fichiers de reporting suivants :

• fichier des transactions ;
• fichier des paiements avec l'option réconciliation.

Comment proposer ApplePay à vos clients ?

Un commerçant souhaitant accepter des paiements via Apple Pay doit demander au support d'activer le moyen de paiement ApplePay sur le compte de d'homologation et de production Payline.

Sur AppMobile (mode API DirectPayment) avec le certificat géré par le commerçant

2. Création d'une application mobile enregistrée dans l'AppleStore par le commerçant pour permettre aux consommateurs de sélectionner les produits et/ou services et proposer le moyen de paiement ApplePay.;

3. L'app application mobile doit proposer le bouton ApplePay et la page de paiement avec le TouchID dans l'application en intégrant le PassKit du SDK d'ApplePay. ;

4. L'application mobile récupère une chaine de caractère "Payment-Data" PaymentData en retour du SDK Apple, puis informe le .
    Ensuite l'application le transmet au serveur commerçant, qui réalise la demande de paiement à Payline Monext avec le service doAuthorization incluant la balise paymentData;

5. Payline Monext décrypté le token PaymentData et réalise la transaction puis retourne le résultat au serveur commerçant par notification serveur en temps réel ;

6. Le serveur commerçant informe l'app Mobil application mobile qui affiche le résultat au consommateurde l'opération.

Sur une page web (mode Widget uniquement)

2. Intégration de du bouton ApplePay avec l'utilisation du button de l'la librairie ApplePay.JS du SDK ApplePay sur la page web checkout en respectant les directives d'ApplePay. ;

3. La page web propose L'app doit proposer la page de paiement avec le TouchID dans l'application en intégrant le SDK d'ApplePay.; 

4. L'app mobile récupère le token de paiement et l'envoi Le navigateur web récupère le PaymentData, qui est transmis au serveur commerçant qui . Ce dernier réalise une demande de paiement doAuthorization à Payline avec le token de paiement.Monext ;

5. Payline Monext décrypté le token PaymentData et réalise la transaction puis retourne le résultat au serveur commerçant .en temps réel ;

6. Le serveur commerçant informe l'app Mobil qui affiche le résultat au consommateur.

Les fonctionnalités de paiement disponibles :

• paiement à la commande : en utilisant le service doWebPaymentRequest / doAuthorization avec payment.mode à CPT et payment.action à 101 ;
• paiement à l'expédition : en utilisant les services services doWebPaymentRequest / doAuthorization et doCapture avec payment.mode à CPT et payment.action à 100 ;
• paiement en différé : en utilisant les services services doWebPaymentRequest / doAuthorization et doCapture avec payment avec payment.mode à DIF et payment.action à 100 ;
• paiement en N fois ;paiement récurrent  ou récurrent : en utilisant le services createWallet et en fonction du besoin un des services doImmediateWalletPayment, doScheduledWalletPayment, doRecurrentWalletPayment  ;
  
• demande d'annulation d'une autorisation non encaissée : utilisez la fonction doReset ;
• demande de remboursement d'une transaction remisée : utilisez la fonction doRefund ;la gestion du 3DS : utilisez les services verifyEnrollment et verifyAuthentication.

Réserves : Les API Web, API widget, API Ajax, traitement Batch, TPEV ne sont pas disponibles.

Comment configurer votre compte ?

Dans le Centre administration de Payline, lors de la création du moyen de paiement, les champs à configurer sont les numéros de contrats Amex, Visa, Mastercard, Discover et le MerchantID d'ApplePay.

Image Removed

Les Fonctions de l'API DirectPayment avec paymentData

L'objet Card contient l'élément PaymentData. Cet élément est disponible en entrée des services de l’API .:

• doAuthorizationRequest.card.paymentData
• createWalletRequest.wallet.card.paymentData
• updateWalletRequest.wallet.card.paymentData

Objet « Payment Data »

Nom du champ

Obligatoire

Format

Commentaire

applicationPrimaryAccountNumber

O

AN

Token de la carte utilisé pour la transaction

applicationExpirationDate

O

DATE

Date d’expiration de la carte.
Format YYMMDD.

currencyCode

O

AN

Code devise chiffré (978 pour Euro).
Format ISO 4217, Alphanumérique pour conserver les « 0 » à gauche

transactionAmount

O

N

Montant de la transaction.
Format défini dans la DCT

cardholderName

N

AN

Nom du porteur de la carte

deviceManufacturerIdentifier

O

AN

Identifiant de fabricant de l’appareil.
Encodé en hexadécimal.

paymentDataType

O

AN

Valeur « 3DSecure » ou « EMV »

paymentData

O

OBJET

Voir le contenu dans le tableau ci-dessous : « Detailed Payment Data ».

Objet « Detailed Payment Data »

Les Fonctions de l'API DirectPayment sans paymentData

La solution proposée consiste à faire passer les informations déchiffrées par le commerçant à travers les doAuthorizationRequest dans les objets suivants:

• Object - card
• Object - authentication3DSecure 

Le commerçant devra renseigner dans l'Object payment le contract number du type ApplePay correspondant.

Le moyen de paiement prend en compte les champs ci-dessous si le champ card.paymentData.TokenData est vide dans le doAuthorizationRequest.

Nom du champ

Obligatoire

Format

Commentaire

onlinePaymentCryptogram

O

AN

Cryptogramme de paiement en ligne comme défini par 3DSecure.
Correspond au CAVV.

eciIndicator

N

AN

Comment réaliser des tests ? 

Les cartes Visa et Mastercard d'une banque partenaire d'Apple seront acceptées par ce moyen de paiement.
Apple met à disposition une plateforme de test « Sandbox » avec des jeux de tests : https://developer.apple.com/support/apple-pay-sandbox/

Note : Il est indispensable de réaliser des tests transactionnels sur l'environnement de production avec des cartes de crédit et de débit après la validation de la mise en œuvre sur l'environnement de test.

Logo du moyen de paiement

Apple propose un lien contenant toutes les normes à respecter : https://developer.apple.com/apple-pay/Apple-Pay-Identity-Guidelines.pdf

Les codes de retour

Payline vous informe du résultat d'un paiement via le code retour des messages « getPaymentDetails » et « getTransactionDetails ».
Lorsque le paiement est accepté, Payline renvoie le code retour à la valeur « 00000 ».

Pour un paiement refusé, le code varie en fonction du motif de refus (Par exemple : 04xxx pour une suspicion de fraude).

Les codes spécifiques au moyen de paiement sont listés en annexe.

Structure du token de paiement ApplePay

Le token de paiment Apple est une structure imbriquée contenant les données de paiement de la transaction pour un acheteur précis. Cet objet est créé par le SDK Apple embarqué.

Image Removed

Les codes sont identiques à ceux utilisés par les moyens de paiement VISA, Mastercard, Discover.La description de chaque champ est fournie par Apple sur : https://developer.apple.com/library/prerelease/content/documentation/PassKit/Reference/PaymentTokenJSON/PaymentTokenJSON.html#//apple_ref/doc/uid/TP40014929

Les liens web

Voici les liens très utiles de la présentation d'ApplePay :

• Apple Pay developer page where all the main documentation and guidelines for Apple Pay in-app are freely available.
• Video of our tech team doing a deep dive on Apple Pay (in-app) @ WWDC. There are some good tips there.
• Link to our Apple Pay identity guidelines for in-app.

Plus d'information commerciale : https://www.apple.com/apple-pay/

Developer Website : https://developer.apple.com

Apple Pay Within Apps : https://developer.apple.com/videos/play/wwdc2015/702/

Apple Pay Programming Guide : https://developer.apple.com/library/ios/ApplePay_Guide/

API JavaScript Apple Pay avec la documentation complète :  https://developer.apple.com/reference/applepayjs

Et pour plus d'information..

Exemple integration par apple : https://developer.apple.com/library/ios/ApplePay_Guide/CreateRequest.html#//apple_ref/doc/uid/TP40014764-CH3-SW2

Contenu du PaymentData : https://developer.apple.com/library/ios/documentation/PassKit/Reference/PaymentTokenJSON/PaymentTokenJSON.html#//apple_ref/doc/uid/TP40014929

Contenu de la réponse d'Apple Pay :https://developer.apple.com/library/ios/documentation/PassKit/Reference/PaymentTokenJSON/PaymentTokenJSON.html#//apple_ref/doc/uid/TP40014929

Payment Token Format Reference : https://developer.apple.com/library/ios/documentation/PassKit/Reference/PaymentTokenJSON/PaymentTokenJSON.html#//apple_ref/doc/uid/TP40014929

Apple Pay Sandbox Testing Details : https://developer.apple.com/support/apple-pay-sandbox/

Passkit Framework Reference : https://developer.apple.com/library/ios/documentation/UserExperience/Reference/PassKit_Framework/

Apple Pay on the Web : https://developer.apple.com/videos/play/wwdc2016/703/

Apple Pay on the Web Website Registration/Verification : https://developer.apple.com/support/apple-pay-domain-verification/

Pages associées