La fonction « createWebWallet » permet d’initialiser la création d’un portefeuille virtuel via l’interface web. Une fois votre client redirigé, il sera invité à saisir ses données bancaires pour créer son portefeuille virtuel. Payline contrôle ces informations par une demande d’autorisation de débit pour un montant d’un euro seulement (la validation n’a pas lieu, donc aucune carte n’est crédité lors de la création) et enregistre le portefeuille de votre client avec l’identifiant (walletID) que vous avez fourni.
Il est nécessaire que le contrat VAD fournit par la banque, autorise le commerçant à pouvoir réaliser des paiements sans cryptogramme soit obtenir un contrat VAD autorisant d’effectuer des paiements récurrent.
Cette fonctionnalité permettra, à partir de la version V4.31, livrée en octobre 2012, la gestion des cartes du portefeuille client. Une fois votre client redirigé, votre client pourra :
- consulter la ou les cartes enregistrées sur son portefeuille ;
- supprimer une carte enregistrée sur son portefeuille ;
- ajouter une carte dans son portefeuille ;
- positionner comme moyen de paiement par défaut une carte de son portefeuille.
Les services createWebWallet et updateWebWallet ont été remplacés par le service manageWebWallet pour les pages web en mode Redirection ou Widget.
Requête à envoyer
La requête « createWebWalletRequest » doit avoir la structure suivante :
Élément | Description | Requis | Type | Exemple | Condition |
version | Version des web services Payline | oui | N2 | A valoriser avec la dernière version : voir le tableau des versions. | |
contractNumber | Le code ou numéro de votre contrat VAD qui représente le moyen de paiement que vous souhaitez utiliser | oui | AN50 | ||
selectedContractList | La liste des numéros de contrat que vous souhaitez utiliser pour ce paiement. Payline affiche la liste des moyens de paiement en respectant l’ordre dans lequel la liste à été renseignée. Si ce champ n’est pas renseigné, Payline affiche l’ensemble de vos moyens de paiement actif sur le point de vente. | non | Object selectedContractList | Voir les éléments ci-dessous | Si 1 seul contrat est rempli, Payline affiche une page de saisie des coordonnées bancaires. Si 2 contrats ou plus sont indiqués, Payline affiche une page de sélection des moyens de paiement |
updatePersonalDetails | Indicateur de possibilité de mise à jour des données personnelles par le porteur du portefeuille. Vide : Mise à jour interdite 0 : Mise à jour interdite 1 : Mise à jour autorisée. | oui | AN1 | ||
buyer | Information sur l’acheteur | non | |||
owner | Information sur le titulaire | non | Object owner | Voir les éléments ci-dessous | |
languageCode | renseignez ce champ avec le code ISO de la langue dans laquelle vous souhaitez faire afficher les pages web de paiement Payline. Par défaut, c’est le navigateur Internet de votre client qui demande à Payline la page dans la langue souhaitée.
fre/fra : Français eng : Anglais cf. liste complète en annexe tableau « Liste des code langues » | non | AN6 | ||
customPaymentPageCode | L’identifiant de personnalisation des pages web du commerçant | non | AN50 | 1fd51s2dfs51 | |
securityMode | Sélection du mode de sécurité à utiliser pour la transaction de paiement | non | AN | SSL cf. liste complète en annexe tableau « Liste des mode sécurité» | |
returnURL | URL sur laquelle le navigateur de l’acheteur est redirigé après validation du paiement sur Payline. | oui | AN255 | http://... ou https://... | |
cancelURL | URL sur laquelle le navigateur de l’acheteur est redirigé s’il décide de ne pas valider le paiement ou que Payline ne peut pas autoriser le paiement de ce client. | oui | AN255 | http://... ou https://... | |
notificationURL | URL sur laquelle Payline va demander au site commerçant de récupérer le résultat de la transaction. | non | AN255 | http://... ou https://... | |
privateDataList | Information sur les informations personnelles | non | |||
customPaymentTemplateURL | URL du template dynamique | non | AN255 | https://.... Uniquement. | |
contractNumberWalletList | contractNumberWalletList | non | Object contractNumberWalletList | Voir les éléments ci-dessous | Non utilisé en mode Widget. RELEASE 4.53 |
Les éléments de référence
Object selectedContractList
Elément | Description | Requis | Type | Exemple |
selectedContractList | La liste des numéros de contrat que vous souhaitez utiliser pour ce paiement. Payline affiche la liste des moyens de paiement en respectant l’ordre dans lequel la liste à été renseignée. Si ce champ n’est pas renseigné, Payline affiche l’ensemble de vos moyens de paiement actif sur le point de vente. Nombre d’occurrence : 1 à 99 | non | AN50 |
|
Object buyer
Élément | Description | Requis | Type | Exemple | Condition |
title | titre | non | AN1 |
| Voir la table des valeurs |
lastName | Nom de l’acheteur | non | AN100 |
| |
firstName | Prénom de l’acheteur | non | AN100 |
| |
Adresse email de l’acheteur | non | AN150 |
| Ne pas mettre plus de 12 chiffres consécutifs (ex.:test-123456789101@test.test) | |
shippingAdress | Adresse de livraison. Le paramètre doit bien être orthographié shippingAdress dans la trame d'appel. | non |
| ||
billingAddress | Adresse de facturation | non | Object Address |
| |
accountCreateDate | La date de création du compte de l’acheteur | non | AN10 | 01/04/16 | Format à respecter : dd/mm/yy |
accountAverageAmount | Le montant moyen des achats de cet acheteur | non | N10 |
| |
accountOrderCount | Le nombre de commande passé par cet acheteur | non | N10 |
| |
walletId | L’identifiant du portefeuille virtuel de votre client. | Non | AN50 |
| Obligatoire pour les paiements par portefeuille |
walletDisplayed | Gestion de l’affichage des moyens de paiement de votre client. Pour ne pas afficher les données de paiement client, saisir la valeur « none ». Pour afficher les données de paiement client, la balise doit être vide ou absente | non | AN5 | ||
walletSecured | Nature du contrôle ajouté à la cinématique de paiement WEB. | non | AN12 | Voir la table des valeurs | |
walletCardInd | Spécifie l’index de la carte à utiliser. | non | AN2 | 1 | L’index de la carte, valeur par défaut « 1 » |
ip | L’adresse IP de l’acheteur | non | AN50 | Format à respecter : IPv4 ou IPv6 | |
mobilePhone | Le numéro de mobile de l’acheteur | non | N15 | 0033691666666
| |
customerId | Identifiant client | non | AN50 | 894492568 | Clearsale : Cette donnée peut être un identifiant ou un email |
legalStatus | Type du status de l'acteur : personne ou entreprise | non | N1 | 1 | Clearsale : voir la table de valeur. |
legalDocument | Numero d'identification du document officiel | non | AN100 | X5446119U | |
birthDate | Date de naissance | non | AN10 | 2016-04-27 | Format: yyyy-mm-dd |
fingerprintID | ID Device fingerprint | non | AN50 | ||
deviceFingerprint | Information du DeviceFingerPrint. | non | AN | à partir de la version 15 | |
isBot | Information du DeviceFingerPrint. Valeur possible : Y ou N | non | AN1 | à partir de la version 15 | |
isIncognito | Information du DeviceFingerPrint. Valeur possible : Y ou N | non | AN1 | à partir de la version 15 | |
isBehindProxy | Information du DeviceFingerPrint. Valeur possible : Y ou N | non | AN1 | à partir de la version 15 | |
isFromTor | Information du DeviceFingerPrint. Valeur possible : Y ou N | non | AN1 | à partir de la version 15 | |
isEmulator | Information du DeviceFingerPrint. Valeur possible : Y ou N | non | AN1 | à partir de la version 15 | |
isRooted | Information du DeviceFingerPrint. Valeur possible : Y ou N | non | AN1 | à partir de la version 15 | |
hasTimezoneMismatch | Information du DeviceFingerPrint. Valeur possible : Y ou N | non | AN1 | à partir de la version 15 |
Object owner
Elément | Description | Requis | Type | Exemple | |
lastName | Nom du titulaire | non | AN30 | Pierre | Applicable uniquement pour AMEX |
firstName | Prénom du titulaire | non | AN15 | Paul | Applicable uniquement pour AMEX |
billingAddress | Adresse de facturation | non |
| Applicable uniquement pour AMEX | |
issueCardDate | Date d’émission de la carte | non | AN4 | Format : mmyy | Applicable uniquement pour AMEX |
Object privateDataList
Élément | Description | Requis | Format | Exemple |
---|---|---|---|---|
privateData | Liste contenant les privateData Nombre d'élément 0 à 100 | oui |
|
Object privateData
Élément | Description | Requis | Format | Exemple |
---|---|---|---|---|
key | Le nom de la clef de la valeur | oui | AN50 | user |
value | Valeur associée à la clef | oui | AN50 | dupond or durand, etc. |
Object contractNumberWalletList
Element | Comment | Required | Format | Exemple | Condition |
---|---|---|---|---|---|
contractNumberWallet | Liste contenant les numéros de contrat du portefeuille. Nombre d'élément 0 à 10. Le mode Widget utilise le Wallet multi-PDV et multi-contrat : le wallet est lié au niveau du marchand. | No |
| Non utilisé en mode Widget. RELEASE 4.53 |
Réponse en retour
La réponse a la structure suivante :
Élément | Description | Requis | Format | Exemple | Condition |
result | Information sur le résultat de la transaction : Code de retour du web service. | oui | 00000 : Transaction approved | ||
token | Jeton horodaté qui permet d’identifier la demande de paiement web du commerçant : token de session | oui | AN50 | ||
redirectURL | URL sur laquelle le navigateur de l’acheteur doit être redirigé pour procéder au paiement. | oui | AN255 | https://webpayment.payline.com |
Les éléments de référence
Object Result
Élément | Description | Format | Exemple |
---|---|---|---|
code | Le code de retour du web service : Opération acceptée : 00000, 02400, 02500, 02501, 02517, 02520 ,02616, 03000, 04000. Autre code : Transaction non acceptée | N5 | Voir le détail des Codes retour Payline |
shortMessage | Message court du résultat de la transaction | AN50 | |
longMessage | Message du résultat de la transaction | AN255 | |
partnerCode | Code retour issu du partenaire (moyen de paiement) | AN50 | à partir de la version 14 |
partnerCodeLabel | Libellé du partenaire | AN255 | à partir de la version 14 |
Commentaires