Content
Presentation
In Widget mode, Payline offers 3 types of processing to manage subscription or recurring payments :
- Payline manages the schedule indicated by the merchant ;
- The merchant manages the schedule and uses the wallet (walletID) ;
- The merchant manages the schedule and uses the Tokenization (TokenPan).
Subscription payment: managed by Payline
Payline offers the management of subscription / recurring payments by relying on the Payline schedule management engine : the merchant programs the deadlines in Payline when the customer takes out a subscription.
The card debit date is chosen by the merchant when creating the schedule.
The payment process
- The consumer fills in his card and validates his order.
- The merchant information system call a doWebPayment web service call to create a payment schedule with REC mode and indicating the schedule (see recurring object : periodicity, date and 1st due date, amount following due dates).
From the second purchase
- The deadlines are created by Payline process. On each creation, Payline calls your notification URL (passed as a parameter of doWebPayment or defined in the administration center) with the parameters described in the notification. This call should trigger a call to getPaymentRecord from you to know the subscription progress.
Subscription payment: managed by the merchant's IS with Payline wallets
En prenant en charge les échéances directement au niveau du SI du commerçant les ordres de débit sur les cartes sont envoyés directement à Payline (par webservice).
La cinématique du paiement de la première échéance est la suivante
- Le SI du commerçant contacte Payline via la fonction doWebPayment pour initier une demande de paiement et d’enregistrement de la carte. Le SI du commerçant affecte à chaque client un identifiant unique qui représente le portefeuille virtuel.
- Le consommateur renseigne sa carte et valide sa commande. Il n’a pas besoin de donner son consentement pour le stockage des données de paiement du fait de l’offre par abonnement.
- Payline réalise la transaction et enregistre les données cartes dans un portefeuille.
- Le SI du commerçant récupère le résultat du paiement via la fonction getWebPaymentDetails.
Dès la seconde échéance, la cinématique du paiement est la suivante
- Le SI du commerçant contacte Payline via le service doImmediateWalletPayment pour réaliser une demande d’autorisation du montant de l’échéance en précisant le walletID concerné.
- Payline réalise la transaction et donne sa réponse en temps réel à la fonction.
Fonction complémentaire
- Payline notifie le SI du commerçant lorsque la carte expire ou lorsqu’elle est mise en opposition.
- Payline fournit un service de gestion des cartes enregistrées dans un portefeuille via le service manageWebWallet.
Subscription payment: managed by the merchant with Tokenization
En prenant en charge les échéances directement au niveau du SI du commerçant les ordres de débit sur les cartes sont envoyés directement à Payline (par web service).
La cinématique du paiement de la première échéance est la suivante
Le SI du commerçant contacte Payline via la fonction doWebPayment pour initier une demande de paiement.
Le consommateur renseigne sa carte et valide sa commande. Il n’a pas besoin de donner son consentement pour le stockage des données de paiement du fait de l’offre par abonnement.
Payline réalise la transaction et construit un alias TokenPan unique du numéro de la carte.
Le SI du commerçant récupère le résultat du paiement ainsi que le TokenPan via la fonction getWebPaymentDetails.
Dès le second achat, la cinématique du paiement est la suivante
- Le SI du commerçant contacte Payline via la fonction doAuthorization avec le TokenPan et la date d’expiration pour réaliser une demande d’autorisation du montant de l’échéance.
- Payline réalise la transaction et donne sa réponse en temps réel à la fonction.
La création des échéances est réalisée aux horaires indiquées ci dessous :
PRODUCTION
- Actif entre 1h et 3h
- Entre 6h et 8h
- Entre 14h et 18h
- Entre 22h et 24h
HOMOLOGATION
- Actif entre 00h et 24h
L'exécution des échéances est réalisé à 00:30.
The timetable display
La fonction en mode Widget est :
Payline.Api.getRecurringDetails().schedules;
Le format de l'échéancier :
{
"type": "REC",
"billingNumber": 20,
"firstAmount": "5,00 EUR",
"billingCycle": "Hebdomadaire",
"amount": "5,00 EUR",
"firstBillingDate": "23/05/2018",
}
L'affichage de la page de paiement résume les informations de l'échéancier :
Le ticket de paiement reprend les informations de l'échéancier de paiement :
Notification of deadlines
Vous avez la possibilité d’être alerter sur une Url de notification de votre choix suite au prélèvement de chacune des échéances.
Payline propose également l’envoi d’un email, entièrement personnalisable, à votre acheteur suite au prélèvement de chacune des échéances.
Ces deux fonctionnalités sont configurables sur notre centre d’administration.
Notification of payment due to the merchant
Cette fonctionnalité est à configurer sur le centre d’administration Payline dans l’onglet « Configuration » / « Vos points de vente »/ « Edition d’un point de vente ».
Pour cela, vous devez renseigner une Url de notification ou nous fournir une URL de notification dans l’appel des web services Payline et cocher la case « Notification des paiements à échéances ».
Liste des paramètres transmis par Payline sur l’URL de notification dans le cadre d’un paiement d’échéance :
- notificationType=BILL
Ce paramètre vous indique le type de paiement pour lequel vous recevez une notification.
« BILL » correspond à la valeur fournie pour un paiement à échéance :
- paymentRecordId=185321
Il s’agit du numéro de dossier de paiement regroupant toute les échéances :
- walletId=1HJb16UJMFmOuD5tCiWS1378738513330
Identifiant du portefeuille utilisé lors du paiement. Dans cet exemple, il s’agit d’un wallet implicite :
- transactionId=10909165550386
Identifiant de la transaction :
- billingRecordDate=20130909
Date de prélèvement de l’échéance :
- orderRef=REF004000112
Référence commande transmise lors de l’initialisation du paiement par le commerçant.
Exemple complet d’URL de notification à échéance :
Notification to the buyer of the various deadlines
Payline vous propose d’avertir le consommateur lors de chaque prélèvement par email.
Vous personnalisez intégralement cet email (contenu, logo, variables disponibles dans le corps du mail).
