Webservice - createWebWalletRequest

S’abonner

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

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
titletitrenonAN1

 

Voir la table des valeurs

lastName

Nom de l’acheteur

non

AN100

 

 

firstName

Prénom de l’acheteur

non

AN100

 

 

email

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

Object Address

 

 

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
legalStatusType du status de l'acteur : personne ou entreprisenonN11Clearsale : voir la table de valeur.
legalDocumentNumero d'identification du document officielnonAN100X5446119U 
birthDateDate de naissancenonAN10

2016-04-27

Format: yyyy-mm-dd 
fingerprintIDID Device fingerprintnonAN50  
deviceFingerprintInformation du DeviceFingerPrint.nonAN à partir de la version 15
isBotInformation du DeviceFingerPrint. Valeur possible : Y ou NnonAN1 à partir de la version 15
isIncognitoInformation du DeviceFingerPrint. Valeur possible : Y ou NnonAN1 à partir de la version 15
isBehindProxyInformation du DeviceFingerPrint. Valeur possible : Y ou NnonAN1 à partir de la version 15
isFromTorInformation du DeviceFingerPrint. Valeur possible : Y ou NnonAN1 à partir de la version 15
isEmulatorInformation du DeviceFingerPrint. Valeur possible : Y ou NnonAN1 à partir de la version 15
isRootedInformation du DeviceFingerPrint. Valeur possible : Y ou NnonAN1 à partir de la version 15
hasTimezoneMismatchInformation du DeviceFingerPrint. Valeur possible : Y ou NnonAN1 à 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

Object addressOwner

 

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

 

 

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

Object result

00000 : Transaction approved
01xxx : Transaction refused
021xx : Internal Error

Voir ci-dessous les éléments

 

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.

ouiAN255

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


partnerCodeCode retour issu du partenaire (moyen de paiement)AN50à partir de la version 14
partnerCodeLabelLibellé du partenaireAN255à partir de la version 14

 

 

Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk