Extrait |
---|
Content
Sommaire | ||||
---|---|---|---|---|
|
Introduction
This page specifies the parameters to be used for authentication and authorization of payments
- recurring with a defined number of installments of the same amount;
- other recurring, ie recurring payments of variable amounts and / or of indefinite duration;
- soucription, also called NX or installments.
General
Ces paiements s'effectuent en deux phases:
- une phase de commande associée au paiement de la première échéance, initiée par l'acheteur sur les pages de l'e-commerçant appelée CIT, Customer Initiated Transaction;
- une seconde constituée des demandes de paiement des échéances suivantes initiées par le marchand hors la présence de l'acheteur appelée MIT Merchant Initiated Transaction.
La demande de paiement de la première échéance doit obligatoirement être authentifiée avec un challenge.
Le numéro de carte peut être saisi par l'acheteur ou récupéré d'un card on file créé précédemment.
Les suivantes sont transmises:
- sans demande d'authentification préalable;
- en référençant la première autorisation.
---
Workflow
These payments are realized in two phasessteps :
- an order phase associated with the first installment payment, initiated by the buyer on the e-merchant pages called CIT, Customer Initiated Transaction ;
- a second made up of realize payment requests for the following installments initiated by the merchant outside the presence of the purchaser called MIT Merchant Initiated Transaction. The shopper is not present.
The payment request for the first installment must be authenticated with a challenge.
The card number can be entered by the buyer or retrieved from a card on file created previously.
The following requests are transmitted :
- without prior authentication request ;
- by referencing the first authorization.
Validation of authentication and authorization requests
Here, you find the values objects for web service interface (cf. authentication an dauthorization processing).
First, the common values to authentication and authorization requests, then the authorization specifics value.
First request
Common values for authentication and authorization requests, then the specifics of the authorization
The tables below give the values and the presence of the different fields for the specific case of NX and recurring payments
Parameter | Mandatory | Comment |
---|
Valorisation des demandes d'authentification et d'autorisation
Nous donnons dans les tableaux ci-dessous les valeurs des champs caractéristiques des différents objets de l'interface web service (cf. traitement authentification + autorisation pour l'enchaînement des web services).
Dans un premier temps les valeurs communes aux demandes d'authentification et d'autorisation puis les spécificités de l'autorisation.
Première échéance
Valeurs communes aux demandes d'authentification et d'autorisation
Les tableaux ci-dessous donnent les valeurs et la présence des différents champs pour le cas spécifiques des paiements NX et récurrents
Objet Payment | ||
---|---|---|
amount | F |
Amount of the first installment. The other installments must have an amount less than or equal to that of the first. | ||
action | O | 122 : |
authorization for a recurring payment with constant amount and fixed duration. 123 : |
124: autorisation pour un paiement écheloné, NX, ou installment
125: autorisation + validation pour un paiement écheloné, NX, ou installment
128: autorisation pour les autres paiements récurrents
authorization + capture for recurring payment with constant amount and fixed duration. 124 : authorization for an installment payment, NX, or installment. 125 : authorization + capture for an installment payment, NX, or installment. 128 : authorization for other recurring payments. 129 : authorization + capture for other recurring payments. |
mode | O | CPT |
cumulatedAmount | O | 0 |
Objet Order | ||
---|---|---|
amount | F |
Order total amount. | ||
Objet Recurring | ||
---|---|---|
firstAmount | O |
First installment amount (priority on payment.amount). | |
amount | C |
Montant des échéances suivantes
Following installments amount. Mandatory for action codes : |
122, 123, 124, 125 |
. Empty for action codes : 128, 129 |
. | |
billingCycle | C |
Frequency, |
for example 40 for a monthly recurrence Mandatory for action codes : |
122, 123, 124, 125 |
. Empty for action codes : 128, 129 |
. | |
billingLeft | C |
Total installments number (3 |
for payment 3 |
times, ...) |
. Mandatory for action codes : 122, 123, 124, 125 |
. Empty for action codes : 128, 129 |
. | ||
billingRank | O | 1 |
for fisrt installment. | ||
endDate | C | Last installment date |
(take a margin that includes the time necessary to repeat the last payment request in error case). Mandatory for action codes : |
122, 123, 124, 125 |
. Empty for action codes : 128, 129 |
. | ||
Objet Buyer | ||
---|---|---|
ip | C |
Must be valued when the buyer uses a web browser. | ||
Objet ThreeDSinfo | ||
---|---|---|
ChallengeInd | F | Payline |
Il s'agit d'un aspect réglementaire.
forces the challenge request into the request sent to the ACS. This is a DSP2 regulatory. The merchant is not required to complete this field |
. | |
browser | C |
Must be valued when the buyer uses a web browser. | |
sdk | C |
Must be valued when the buyer is logged in via a mobile application using a sdk plugin. |
Spécificités autorisation
L'autorisation peut être effectuée avec un Authorization can be done with a
- doAuthorization;
- doImmediateWalletPayment;
ParamètreParameter | PrésenceMandatory | CommentaireComment |
---|---|---|
authentication3DSecure. md | O | |
authentication3DSecure. pares | O |
Stockage des données de paiement dans un wallet Payline.
Cette étape permet de stocker les données de paiement dans un wallet Payline.
Elle n'est possible que si l'autorisation a été effectuée avec un doAuthorization.
Elle est facultative.
Il faut faire appel au web service createWallet en précisant:
- le numéro de contrat
- l'identifiant de wallet
- l'identifiant de transaction Payline donné en réponse du doAuthorization.
Save payment data in Payline wallet
This step allows payment data to be stored in a Payline wallet.
It is only possible if the authorization has been done with a doAuthorization.
It is optional.
You must use the createWallet web service specifying:
- the contract number
- the wallet identifier
- the Payline transaction identifier given in response to the doAuthorization.
Other installments
Payment requests for other installments are initiated by the merchant without the shopper, there is no authentication.
Authorization settings
The authorization request can be realized using :
Autres échéances
Les demandes de paiement des autres échéances sont initiées par le marchand hors la présence de l'acheteur, il n'y a pas d'authentification.
Paramétrage de l'autorisationLa demande d'autorisation peut être effectuée en utilisant:
ParamètreParameter | PrésenceMandatory | CommentaireComment | |||
---|---|---|---|---|---|
linkedTransactionID | C | Valeur retournée dans la réponse à la première demande d'autorisation dans le paramètre Value returned in the first authorization response in the 'linkedTransactionId' .Si l'autorisation initiale est effectuée avant la mise en application des RTS SCA se référer à la description du ‘Grand fathering’ Facultatif pour actions 128/129 avec utilisation d'un doImmediateWalletPayment ou doScheduledWalletPayment si le wallet a été créé avec la transaction de la 1ere échéance (Payline utilise le linkedTransactionID stocké lors de la création du wallet). Obligatoire dans les autres cas parameter. If the initial authorization is realized before the RTS SCA application, refer to "Grand fathering" description below. Optional for 128/129 actions with using of doImmediateWalletPayment or doScheduledWalletPayment if the wallet was created with the first installment transaction (Payline uses the linkedTransactionID stored when the wallet was created). Mandatory in other cases. | |||
resultContainer | C | Value returned in the first authorization response in the 'resultContainer' parameter. Missing if Grand fathering, Optional for 128/129 actions with using of doImmediateWalletPayment or doScheduledWalletPayment if the wallet was created with the first installment transaction (Payline uses the linkedTransactionID stored when the wallet was created). Mandatory in other cases. | resultContainer | C | Valeur retournée dans la réponse à la première demande d'autorisation dans le paramètre 'resultContainer'. Absent si Grand fathering, Facultatif pour actions 128/129 avec utilisation d'un doImmediateWalletPayment ou doScheduledWalletPayment si le wallet a été créé avec la transaction de la 1ere échéance (Payline utilise le resultContainer stocké lors de la création du wallet). Obligatoire dans les autres cas |
Objet Payment | |||||
action | OMême valeur que dans les appels précédents | Same value as in previous calls. | |||
mode | O | CPT | |||
amount | O | Montant de l'échéance (prime sur Installment amount (priority ib recurring.amount). | |||
cumulatedAmount | C Somme des montants déjà autorisés. | Sum of amounts already authorized. Missing for 'other recurring payments'. Absent pour 'autres paiements récurrents' | |||
Objet Recurring | |||||
billingRank | C | 2 pour la 2e échance, 3 pour la 3efor the 2nd installment, 3 for the 3rd, etc ...Obligatoire pour les codes action ( Mandatory for action codes : 122, 123, 124, 125)Recommandé pour les codes action (128, 129), valeur strictement supérieure à 1 | autres champs | Mêmes valeurs que dans les appels précédents | 125.
Recommended for action codes : 128, 129, value strictly greater than 1. |
.. others fields | Same value as in previous calls. | ||||
Authenticated amount
The table below specifies the amount to be provided for authentication request for each payment type.
Payment | Payment code | Authenticated amount |
---|---|---|
recurring with defined installments number and same amount | 122 or 123 | Total amount : sum of installments amount |
other installments | 128 or 129 | First installment amount. For American Express, Mastercard, the other installments amount must not exceed that of the first one. (TO BE CONFIRMED). |
NX, installments | 124 or 125 | Total amount : sum of installments amount |
Montant authentifié
Le tableau ci-dessous précise le montant à fournir à la demande d'authentification en fonction du paiement
Paiement | Payment code | Montant authentifié |
---|---|---|
récurrents avec des échéances en nombre défini et de même montant | 122 ou 123 | Montant total: somme du montant des échéances |
autres récurrents | 128 ou 129 | Montant de la première échéance Pour American Express, Mastercard, le montant des autres échéances ne doit pas excéder celui de la première. Semble remis en cause actuellement (A CONFIRMER). |
échelonnés, NX, installments | 124 ou 125 | Montant total: somme du montant des échéances |
AncreGrandFathering GrandFathering
Grand fathering
GrandFathering | |
GrandFathering |
Ce paragraphe traite des paiements récurrents et Nx initiés avant l'application de la dsp2 et n'ayant pas pu récupérer auprès du serveur d'autorisation la référence d'autorisation initiale.
Le marchand pour chaque demande de paiement d'échéance :
This paragraph deals with recurring and Nx payments initiated before DSP2 application and which could not retrieve the initial authorization reference from the authorization server.
For each installment payment request, the merchant :
- sends as initial transaction identifier the valueenvoie comme identifiant de transaction initiale la valeur : '** PV4-999999999999'
- récupère l'identifiant de transaction dans la réponse à la demande de paiement
- retrieves the transaction identifier in the response to the payment request
- if this identifier is different from si cet identifiant est différent de '** PV4-999999999999', la mémorise et l'utilise comme identifiant de transaction initiale dans les demandes de paiement ultérieures.
Le resultContainer n'est jamais envoyé.
Changement et renouvellement de carte
Ce paragraphe traite du cas du changement de carte pour un paiement récurrent ou n fois en cours.
Le changement est effectué par l'acheteur sur les pages du commerçant.
Le commerçant propose à son acheteur de venir modifier ses données de paiement.
Il lui présente une demande de paiement récurrent de montant variable de durée indéterminée (code 128).
- stores it and uses it as the initial transaction identifier in subsequent payment requests.
The resultContainer is never sent.
Card change and renewal
This paragraph process the case of changing the card for a recurring payment or n times in progress.
The change is realized by the buyer on the merchant web pages.
The merchant offers his shopper to modify his payment data.
The merchant realizes a recurring payment request with variable amount and with an unlimited duration (code 128).
The merchant retrieves the identifier (linkedTransactionId) and the resultContainer.
The merchant can continue the installment request using the new identifier and the new resultContainer.
Pages linked
Il récupère l'identifiant de regroupement (linkedTransactionId) et le resultContainer.
Il peut ensuite reprendre le recouvrement des échéances en utilisant le nouvel identifiant de regroupement et le nouveau resultContainer.
Pages associéesContenu par étiquette | ||||||||
---|---|---|---|---|---|---|---|---|
|