...
Pour procéder à un paiement récurrent, le commerçant devra suivre les étapes suivantes :
Initialisation
1. Un premier paiement doit être effectué (appel payssl.aspx) en ajoutant le paramètre RTF=I pour indiquer qu’il s’agit d’un paiement initial.
2. Vous obtenez dans la réponse de cet appel 3 paramètres 4 paramètresà stocker :
-PCNr (Pseudo Card Number) : alias/token réutilisable par la suite.
-CCBrand
-CCExpiry
-Un schemeReferenceID -->Identification de transaction spécifique au scheme de carte requise pour les paiements chaînés
=> Ces trois quatre paramètres seront nécessaires pour les paiements récurrents qui seront effectués via une requête en Serveur to serveur, c'est-à-dire via direct.aspx, ou bien via paynow.aspx.
Paiement récurrent
3. Lancer une requête direct.aspx avec les paramètres obligatoires (voir tableau des paramètres plus bas dans cette section).
-Les paramètres "CCNr", "CCExpiry" et "CCBrand" seront ceux récupérés dans la réponse du paiement initial.
-Veilliez à bien ajouter le paramètre "RTF=R" dans chacune de vos transactions récurrentes.
-Ajoutez également le paramètre "Vbv=no", qui vous permettra de forcer la non-utilisation de la procédure d'authentification 3Dsecure
-Le schemeReferenceID reçus en réponse de la requête de paiement initiale afin de chaîner les transactions
Les moyens de paiement permettant de faire du paiement récurrent (abonnement) sont les suivants :
...
Le tableau suivant décrit les paramètres du résultat transmis par la plateforme de paiement à URLNotify, URLSuccess ou URLFailure. Si vous avez spécifié le paramètre Response=encrypt, les paramètres suivants sont envoyés chiffrés avec la méthode Blowfish à votre système :
Paramètre | Format | CND | Description | |||
---|---|---|---|---|---|---|
MID | ans..30 | M | Identifiant du commerçant (MerchantID) attribué par BNP Paribas. | |||
PayID | an32 | M | Identifiant attribué par la plateforme de paiement pour le paiement ; p. ex. pour référencement dans les fichiers batch | |||
XID | an32 | M | Identifiant pour toutes les transactions uniques (autorisation, capture, remboursement) pour un paiement attribué par la plateforme de paiement | |||
TransID | ans..64 | M | Numéro de transaction du commerçant | |||
refnr | an12 | OC | Le numéro de référence univoque du commerçant, qui sert de référence de remboursement dans le fichier EPA de l'acquéreur. Veuillez noter que sans la livraison de référence propre à la boutique, vous ne pouvez pas lire la transaction EPA ; quant au fichier de règlement supplémentaire, nous ne pouvons pas ajouter les données de paiement supplémentaires. Notes:
| |||
Status | a..50 | M | OK / AUTHORIZED (URLSuccess) / FAILED (URLFailure) | |||
Description | ans..1024 | M | Détails supplémentaires dans le cas où le paiement est rejeté. N’utilisez pas la Description, mais le paramètre Code pour l’analyse du statut de transaction ! | |||
Code | n8 | M | Code erreur de réponses de la plateforme de paiement (voir fichier Excel des codes erreur) | |||
MAC | an64 | M | Code HMAC (Hash Message Authentication Code) avec algorithme SHA-256 | |||
UserData | ans..1024 | O | Si cela est spécifié dans la requête, la plateforme de paiement transmet le paramètre avec le résultat du paiement à la boutique | |||
PCNr | n16 | O | TOKEN (Pseudo Card Number, numéro de carte temporaire) : numéro aléatoire généré par la plateforme de paiement qui représente un numéro de carte authentique. Le TOKEN (PCN) commence par 0, et les 3 derniers chiffres correspondent à ceux du véritable numéro de carte. Vous pouvez utiliser le PCN comme un numéro de carte authentique pour une autorisation, une capture et un remboursement. | |||
CCBrand | a..22 | OC | Désignation de la marque de carte | |||
CCExpiry | n6 | OC | En combinaison avec PCNr : date d’expiration de la carte au format AAAAMM (201706). | |||
maskedpan | an..19 | OC | Numéro de carte masqué 6X4 | |||
CAVV | ans..40 | OC | Dans le cas de 3D Secure avec hébergement d’authentification (requête 3D sans autorisation uniquement) : valeur de validation d’authentification de porteur de carte : contient la signature numérique pour l’authentification avec l’ACS de la banque émettrice de la carte. | |||
ECI | n2 | OC | Pour 3D Secure : l’indicateur d’e-commerce ACS : définit le niveau de sécurité d’un paiement par carte via les différents canaux de communication : MOTO, SSL, Verified by Visa, etc. | |||
DDD | a1 | C | Pour l’hébergement d’authentification 3D Secure : Y - entièrement authentifié (authentification complète effectuée) N - not enrolled (vérifié, mais l’émetteur ne participe pas) U - non éligible (erreur technique) A - attempt (la carte ne participe pas) B - bypass (contournement, uniquement pour CardinalCommerce) | |||
Type | ans..20 | C | Pour 3D Secure uniquement, en réponse à URLNotify : abréviation du type de paiement, (exemple : SSL) | |||
Plain | ans..50 | O | Une valeur définie par le commerçant pour retourner certaines informations non chiffrées (p. ex. identifiant du commerçant) | |||
Custom | ans..1024 | O | Le commerçant peut soumettre plusieurs valeurs séparées par | et qui sont retournées non chiffrées et séparées par &. Custom=session=123|id=456 devient dans la réponse Session=123&id=456 | |||
CustomField[n] | ans..50 | O | Champ pouvant être utilisé individuellement par le commerçant. Actuellement, 9 champs de CustomField1 à CustomField9 sont pris en charge. | |||
ans..64 | M | Identification de transaction spécifique au scheme de carte, requise pour les paiements chaînés ultérieurement, les autorisations retardées et les remises
|