Webservice - createWebWalletRequest

S’abonner

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

ouiAN50

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.
nonObject - selectedContractListVoir 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.
ouiAN1

buyer

Information sur l’acheteur

non

Object - buyer

Voir les éléments ci-dessous


ownerInformation sur le titulairenonObject - ownerVoir 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 »
nonAN6

customPaymentPageCodeL’identifiant de personnalisation des pages web du commerçantnonAN501fd51s2dfs51
securityMode

Sélection du mode de sécurité à utiliser pour la transaction de paiement

nonAN

SSL

cf. liste complète en annexe tableau « Liste des mode sécurité»

returnURLURL sur laquelle le navigateur de l’acheteur est redirigé après validation du paiement sur Payline.ouiAN255http://... ou https://...
cancelURLURL 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.ouiAN255http://... ou https://...
notificationURLURL sur laquelle Payline va demander au site commerçant de récupérer le résultat de la transaction.nonAN255http://... ou https://...

privateDataList

Information sur les informations personnelles

non

Object PrivateDataList

Voir les éléments ci-dessous


customPaymentTemplateURLURL du template dynamiquenonAN255https://.... Uniquement.
contractNumberWalletListcontractNumberWalletListnonObject - contractNumberWalletListVoir les éléments ci-dessousNon 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  :

  • No, if Webservice Version is empty or <4
  • Yes, if Webservice Version> = 4


Object buyer


Field

Description

Mandatory

Type

Example

Condition
titleTitle of civilityNoAN1


See the table of values

lastName

Name of the buyer

No

AN100



firstName

Buyer's name

No

AN100



email

Buyer's email address

No

AN150


Do not put more than 12 consecutive digits (eg test123456789101@test.test )

shippingAdress

Delivery address.

No

Object Address



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
legalStatusType of status of the actor: person or companyNoN11Clearsale: see the table of value.
legalDocumentIdentification number of the official documentNoAN100X5446119U
birthDateBirth date. Format: yyyy-mm-dd NoAN10

2016-04-27


fingerprintIDDevice ID fingerprintNoAN50

deviceFingerprintDeviceFingerPrint information.NoAN
from version 15
isBotDeviceFingerPrint information. Possible value: Y or NNoAN1
from version 15
isIncognitoDeviceFingerPrint information. Possible value: Y or NNoAN1
from version 15
isBehindProxyDeviceFingerPrint information. Possible value: Y or NNoAN1
from version 15
isFromTorDeviceFingerPrint information. Possible value: Y or NNoAN1
from version 15
isEmulatorDeviceFingerPrint information. Possible value: Y or NNoAN1
from version 15
isRootedDeviceFingerPrint information. Possible value: Y or NNoAN1
from version 15
hasTimezoneMismatchDeviceFingerPrint information. Possible value: Y or NNoAN1
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

Object - addressOwner


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



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



Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk