Amex recurring - Intégration

S’abonner




Comment proposer ce paiement à vos clients ?

Les principes d’utilisation

Une fois le moyen de paiement activé, il est utilisable au travers des fonctions standard Payline en indiquant le contrat du moyen de paiement Contrat_Number. 
Le mode d'intégration est disponible avec l'API WebPayment  : services doWebPayment et getWebPaymentDetails
Le mode d'intégration avec l'API DirectPayment avec le service  doAuthorization.


Comment réaliser l'intégration dans Payline

1) createWallet


Exemple pour la création du wallet W1 :




2) NOTIFICATION du retour d'enrollement d' AMEX

  • A réception  des retours d' enrollement  d' AMEX.
  • PAYLINE mets à jour le status du wallet à EA ( Enrolment Accepted )  : Enrôlement  Accepté par AMEX.
  • PAYLINE notifie le commerçant sur son URL.


Exemple :

https://xxxxxxxxxx?notificationType=Wallet&walletId=W1&type=smartbillEnrollResult&result=Y&resultCode=S
xxxxxxx= URL de notification du commerçant
notificationType=Wallet
walletId=W1
type=smartbillEnrollResult
result=Y
resultCode=S


  • Le commerçant acquitte la notification si réception alors code retour 200.
  • Sur réception de l'acquittement , PAYLINE stoppe la notification sur le wallet W1.


3)  getWallet   


Exemple pour le wallet W1:



Exemple avec les wallets que nous avions créés ensemble  via le TPEV :





Comment gérer son Portefeuille :

Il est possible de modifier un Portefeuille, de mettre à jour les données privées et/ou les données monétiques à l'aide de la fonction « updatewallet », et il est tout à fait possible de désactiver un Portefeuille à l'aide de la fonction « disableWallet », lorsqu'un portefeuille est désactivé, il n'est plus possible d'effectuer des paiements via celui-ci.

Information du Portefeuille

A tout moment, il est possible d'utiliser les fonctions suivantes qui vous permettent d'interroger votre Portefeuille :

  • « getWallet » cette fonction permet de récupérer les informations qui constituent un portefeuille client ;
  • « getPaymentRecord » cette fonction permet de récupérer les informations d'un dossier de paiement récurrent.


4) disableWallet



Le status du wallet  est à MAN  et le flag  isdisable est à 1 : désactivation  MANuelle


5) doScheduledWalletPayment  


Exemple de la programmation au 06/12/2016 d'un paiement  de 10 € sur le wallet W1 :

  • Pas de rejet technique, le paiement est bien programmé ( code retour 02500 ) et un dossier de paiement est créé.



6)  getPaymentRecord



7) NOTIFICATION du retour  du paiement

  • Réception  du résultat du paiement.
  • PAYLINE mets à jour le dossier de paiement.
  • PAYLINE notifie le commerçant sur son URL.


Exemple  

https://xxxxxxxxxx?notificationType= BILL&paymentRecordId=37xx6 &walletId=W1&transactionId=263xxxxxxx6106&billingRecordDate=20161121&orderRef=TST_commerçant_W1&cardIndex=1&billingRecordId=xxxxxxx

paymentMode=CPT
xxxxxxx= URL de notification du commerçant
notificationType=BILL
paymentRecordId=37xx26
walletId=W1
transactionId = 263xxxxxxx06


  • Les paramètres qui suivent peuvent être différents suivant les types de paiement.
  • Le commerçant acquitte la notification si  réception : code retour 200.
  • Sur réception de l' acquittement , PAYLINE stoppe la notification sur le recordpayment 3xxx6.
  • Pour connaitre le résultat du paiement , le commerçant pourra faire appel au WS vu précédemment getPaymentRecord   ou getTransactionDetails
    • getPaymentRecord(AMEX_REC,3xxx6)
    • getTransactionDetails (26xxxxxxxxx106)


                                                                  
     7.a) getPaymentRecord (AMEX_REC, 37xx26 )



     7.b) getTransactionDetails (263xxxxxx6106 ) avec affichage historique



8)  NOTIFICATION d'un retour de status carte résiliée

  • Réception  d'AMEX d'une mise à jour wallet pour carte résiliée.
  • PAYLINE met à jour le status du wallet à CC ( Card Cancelled )  : carte résiliée.
  • Payline notifiie le commerçant sur son URL.

Exemple  :

https://xxxxxxxxxx?notificationType=Wallet&walletId=W1&type=smartbillCanceledCard&CancellationCode=R999
xxxxxxx= URL de notification le commerçant
notificationType=Wallet
walletId=W1
type=smartbillCanceledCard
CancellationCode=R999

  • Le commerçant acquitte la notification si  réception : code retour 200.
  • sur réception de l'acquittement , PAYLINE stoppe la notification sur le wallet W1




9) A partir du centre d'admin  PAYLINE

    1. Se connecter sur le commerçant
    2. Aller dans le menu Paiement Récurent
    3. Gestion des portefeuilles :  Afficher les portefeuilles actifs ;  nous retrouvons le wallet crée ce jour W1



d.  Sélectionner le wallet W1 : il y a 3 dossiers de paiement ( 37xx06 , 37xx16 , 37xx26 )



e. Sélectionner le dossier 37xx26



f. Sélectionner le dossier 375226 : le paiement est à venir , il est programmé au 06/12/2016  alors que le suivant a été effectué et est remisé



g. On pourra donc trouver  ce paiement  dans le menu Transactions de paiement ; récupérer l' Id Trans de l' écran ci-dessus : 26337190216106  et effectuer une recherche avec l' identifiant de la transaction ,ce qui donne :



h. Sélectionner la transaction : 26337190216106



Les privatedatas  :



Comment réaliser des tests ?

Il vous faut obtenir une carte de test Amex

Les codes de retour

Avec l'API WebPayment, Payline vous informe du résultat d'un paiement via le code retour des messages getWebPaymentDetails et getTransactionDetails.
Avec l'API DirectPayment, Payline vous informe du résultat de manière synchrone en réponse du doAuthorization
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 ici.

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0
Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk