Contenu
| Sommaire | ||||
|---|---|---|---|---|
|
Comment configurer votre compte ?
Vous devez vous rapprocher de votre responsable de compte bancaire pour obtenir les informations nécessaires permettant de configurer votre compte moyen de paiement sur Payline (contrats VAD).
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 Payline 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.
Inclusion d'extrait Contactez le support Payline Contactez le support Payline nopanel true
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.
Configuer l'EDI XCode d'Apple
Lorsque vous ouvrez un projet, il faut paramétrer le marchandID. Cet identifiant sera fourni par Payline.
| Extrait |
|---|
La validation des domaines n'est pas systématiquement demandée par Apple. Cette étape est à effectuer côté Payline et sur votre compte Apple developer. |
Comment proposer ApplePay à vos clients ?
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 à Payline avec la carte bancaire.
- En Web/App avec webview : le commerçant réalise un doWebPayment sur un contrat ApplePay de Payline. 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 :
- Le commerçant doit activer le moyen de paiement sur centre administration Payline.
Sur AppMobile (mode API DirectPayment)
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 ;
4. L'application mobile récupère une chaine de caractère PaymentData en retour du SDK Apple. Ensuite l'application le transmet au serveur commerçant, qui réalise la demande de paiement à Payline avec le service doAuthorization ;
5. Payline décrypté 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.
Sur une page web
2. Intégration du bouton ApplePay avec la librairie ApplePay.JS du SDK ApplePay sur la page web checkout en respectant les directives d'ApplePay ;
3. La page web propose doit proposer la page de paiement avec le TouchID ;
4. Le navigateur web récupère le PaymentData, qui est transmis au serveur commerçant. Ce dernier réalise une demande de paiement doAuthorization à Payline ;
5. Payline décrypté 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 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 doWebPaymentRequest / doAuthorization et doCapture avec payment.mode à CPT et payment.action à 100 ;
- paiement en différé : en utilisant les services doWebPaymentRequest / doAuthorization et doCapture avec payment.mode à DIF et payment.action à 100 ;
- paiement avec un portefeuille électronique : en utilisant les services createWallet et doImmediateWalletPayment ;
- paiement en N fois 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.
Les Fonctions de l'API DirecPayment 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
| Développer | |||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||
Un commerçant qui souhaite utilisé le mode direct, doit remplir les champs du doAuthorization suivant avec les informations récupérées dans le PAYLOAD ApplePay en plus des champs standards PAYLINE.
|
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:
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.
| Développer | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||
Mapping du Payload d'ApplePay
|
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 getWebPaymentDetails 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 sont identiques à ceux utilisés par les moyens de paiement VISA, Mastercard, Amex, Discover.
Les codes retour sont listés ici.
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
Pages associées
| Contenu par étiquette | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|