Introduction
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. | 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. |
| 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
Field | Description | Mandatory | Type | Condition |
selectedContractList | The list of contract numbers you want to use for this payment. Payline displays the list of payment methods in the order in which the list has been filled. If this field is not filled in, Payline displays all of your active means of payment at the point of sale. Number of occurrences: 1 to 99 | No | AN50 | Filed required as following :
|
Object buyer
Field | Description | Mandatory | Type | Example | Condition |
| title | Title of civility | No | AN1 | See the table of values | |
lastName | Name of the buyer | No | AN100 | ||
firstName | Buyer's name | No | AN100 | ||
Buyer's email address | No | AN150 | Do not put more than 12 consecutive digits (eg test123456789101@test.test ) | ||
shippingAdress | Delivery address. | No | |||
billingAddress | Billing address | No | Object Address | ||
accountCreateDate | The date of creation of the buyer's account. Format : dd/mm/yy | No | AN10 | 01/04/16 | |
accountAverageAmount | The average amount of this buyer's purchases | No | N10 | ||
accountOrderCount | The number of orders placed by this buyer | No | N10 | ||
walletId | The identifier of the virtual wallet of your client. | No | AN50 | Mandatory for wallet payment | |
walletDisplayed | Management of the display of the means of payment of your customer. To not display the customer payment data, enter the value "none". To display the customer payment data, the tag must be empty or absent. | No | AN5 | ||
walletSecured | Nature of the control added to the payment kinematics WEB. | No | AN12 | See the table of values | |
walletCardInd | Specifies the index of the map to use. | No | AN2 | 1 | The index of the map, default value "1" |
ip | The IP address of the buyer. Format : IPv4 or IPv6 | No | AN50 | ||
mobilePhone | The mobile number of the buyer | No | N15 | 0033691666666 | |
customerId | Customer ID | No | AN50 | 894492568 | Clearsale: This data can be an identifier or an email |
| legalStatus | Type of status of the actor: person or company | No | N1 | 1 | Clearsale: see the table of value. |
| legalDocument | Identification number of the official document | No | AN100 | X5446119U | |
| birthDate | Birth date. Format: yyyy-mm-dd | No | AN10 | 2016-04-27 | |
| fingerprintID | Device ID fingerprint | No | AN50 | ||
| deviceFingerprint | DeviceFingerPrint information. | No | AN | from version 15 | |
| isBot | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 | |
| isIncognito | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 | |
| isBehindProxy | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 | |
| isFromTor | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 | |
| isEmulator | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 | |
| isRooted | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 | |
| hasTimezoneMismatch | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 |
Object owner
Field | Description | Mandatory | Type | Example | Condition |
lastName | Owner lastname | No | AN30 | Pierre | Applicable only for AMEX |
firstName | Owner firstname | No | AN15 | Paul | Applicable only for AMEX |
billingAddress | Billing adress | No | Applicable only for AMEX | ||
issueCardDate | Issue card date. Format : mmyy | No | AN4 | 0118 | Applicable only for AMEX |
Object privateDataList
Field | Description | Mandatory | Format | Example |
|---|---|---|---|---|
privateData | List containing privateData Number of items 0 to 100 | Yes |
Object privateData
Field | Description | Mandatory | Format | Example |
|---|---|---|---|---|
key | Key name of value | Yes | AN50 | user |
value | Key value | Yes | AN50 | Martin |
Object contractNumberWalletList
Field | Description | Required | Format | Example | Condition |
|---|---|---|---|---|---|
contractNumberWallet | List containing the contract numbers of portfolio. Number of elements 0 to 10. The Widget mode uses the multi-PDV and multi-contract wallet: the wallet is linked to merchant level. | No | Not used in Widget mode. RELEASE 4.53 |
Commentaires