Page tree
Skip to end of metadata
Go to start of metadata



Contenu


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 Payline.
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.

Contactez le support Payline.

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.


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. 
Pour configurer le contrat Apple pay en homologation, il faut juste nous transmettre merchant name et nous préciser le point de vente sur lequel nous devons générer les certificats, puis nous vous les transmettrons. 

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 :

  1. 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 :

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


 Le Payload d'ApplePay et Payline..

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.

Payload Apple Pay

doAuthorizationRequest

Commentaires

paymentNetwork

card.PaymentData.Network

Pas de transformation : Réseaux supportés: VISA / MASTERCARD / AMEX.

applicationPrimaryAccountNumber

card.number

Pas de transformation : Token PAN contenu dans le PAYLOAD déchiffré par le commerçant.

applicationExpirationDate

card.expirationDateA convertir au format MMYY.
currencyCodepayment.currencyCode devise numérique ISO 4217.
transactionAmountpayment.amountPlus petite unité de la devise (100 = 1€).
cardholderNamecard.cardholderPas de transformation.

paymentData.onlinePaymentCryptogram

authentication3DSecure.cavv

Pas de transformation : Apple Pay fournit systématique le CAVV.

Dans le cas où le CAVV ne serait pas transmis par le commerçant, PAYLINE rejettera la demande de paiement.

paymentData.eciIndicator

authentication3DSecure.eci

Pas de transformation : Apple Pay ne fournit pas systématiquement l'ECI.

Le commerçant doit renvoyer la valeur tel quel.


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.


 Le Payload d'ApplePay et Payline..
Mapping du Payload d'ApplePay


Payload XPay

doAuthorizationRequest

Obligatoire

Commentaires

Réseau de la carte

card.PaymentData.Network

OUI

Donnée déchiffrée dans le PAYLOAD tel quel sans transformation.

Token ou PAN de la carte

card.numberOUI

Date d'expiration

card.expirationDateOUI

Devise

payment.currencyOUI

Ce champ n'est pas forcément présent dans le PAYLOAD.

Dans ce cas, le commerçant doit le renseigner lui même.

Montant

payment.amountOUI

Ce champ n'est pas forcément présent dans le PAYLOAD.

Dans ce cas, le commerçant doit le renseigner lui même.

Titulaire de la carte

card.cardholderNON

Ce champ n'est pas forcément présent dans le PAYLOAD.

Dans ce cas, le commerçant doit le laisser vide.

Cryptogram

authentication3DSecure.cavv

NON

Ce champ n'est pas forcément présent dans le PAYLOAD.

Dans ce cas, le commerçant doit le laisser vide.

ECI

authentication3DSecure.eciNON

Ce champ n'est pas forcément présent dans le PAYLOAD.

Dans ce cas, le commerçant doit le laisser vide.


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