Webservice - getWebWalletRequest

S’abonner

Il est impératif après la création ou la mise à jour d’un WALLET, d’utiliser le webservice getWebWallet, qui vous garantira le résultat obtenu.

La méthode permet de récupérer les informations d’un portefeuille virtuel crée via l’interface web.

Requête à envoyer

La requête « getWebWalletRequest»  comprend :

 

Élément

Description

Requis

Type

Exemple

version

Version des web services Payline

oui

N2

A valoriser avec la dernière version : voir le tableau des versions.

token

Jeton de session horodaté qui permet d’identifier le commerçant.

oui

AN50

 

 

Réponse en retour

Le message « getWebWalletResponse» est la réponse d’une demande d’informations d’un portefeuille virtuel.

La réponse a la structure suivante :

Élément

Description

Requis

Type

Exemple

Condition
resultInformation sur le résultat de la demande d'information du walletouiObject resultVoir ci-dessous les éléments
walletInformation sur le portefeuillenonObject walletVoir ci-dessous les éléments
ownerInformation sur le titulairenonObject ownerVoir ci-dessous les éléments

privateDataList

Information sur les informations personnelles

non

Object PrivateDataList

Voir ci-dessous les éléments


extendedCard

Information supplémentaire sur la carte

nonObject extendedCardTypeVoir ci-dessous les éléments

media

Détection du média utilisé lors du paiement.
Les valeurs possibles de cette balise sont :

-       Computer
-       Mobile
-       Tablet
-       TV
-       Console
-       Undefined

non

AN25

Mobile


numberOfAttempt

Le nombre de tentatives faites par le client lors de son paiement web.

Liste des valeurs possibles :
- 0 : Aucune tentative de paiement
- 1, 2 ou 3 tentatives de paiement

- 4, 5 ou 6 tentatives de paiement (uniquement possible avec l’option rejeu de la transaction)
nonN1 5
contractNumberWalletList

Un tableau des numéros de contrat du wallet. 

nonObject contractNumberWalletListVoir ci-dessous les élémentsNon utilisé en mode Widget RELEASE 4.53

 

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

 

Object wallet


Élément

Description

Requis

Type

Exemple

Condition

walletId

L’identifiant unique du portefeuille virtuel. Vous devez communiquer à Payline un identifiant unique qui correspond à un et un seul acheteur sur votre système d’information. C’est avec ce même identifiant vous pourrez demander un paiement par portefeuille virtuel.

oui

AN50



lastNameLe nom de l'acheteur. Ces informations sont utiles pour rechercher un portefeuille dans le Centre d’Administration Commercant.nonAN100

firstName

Prénom de l'acheteur.

non

AN100



email

L’adresse de messagerie de l'acheteur. Payline utilisera cette information pour envoyer un justificatif de paiement à votre client.

non

AN150


shippingAddress

Adresse de livraison de l'acheteur

non

Object address



cardInformations de la carte de l'acheteurouiObject card

commentCommentairesnonAN255

defaultCarte enregistrée par défautnonAN1Y or N : Carte par défaut
cardStatus

Les valeurs possibles :
- EXP : Date expirée
- OPP : mise en opposition
- MAN : désactivation manuelle
- INT : règles internes

nonAN3EXP
cardBrand

Indique la marque utilisée pour l'opération :

CodeLibellé
0CB
1VISA
4MASTERCARD
5MAESTRO
8BCMC

Il n’est pris en compte que si le moyen de paiement permet le choix de la marque.

nonN1CBà 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 extendedCardType


Élément

Commentaire

Requis

Exemple

country

Pays d’emission de la carte

AN2

CODE ISO : exemple FR

isCvd

La carte est elle une e carte bleu

AN1

Y OR N

bank

La banque de la carte utilisée pour le paiement

AN

Crédit Lyonnais

type

Le type de carte de paiement

AN20

MASTERCARD

network

Désigne le rattachement de la carte à une entité gérant l’acceptation de la carte à un niveau national ou international

AN20

MASTERCARD

product

Indique la catégorie à laquelle appartient le type de la carte : voir les codes produit

AN

Gold/Premier pour une carte type VISA

 

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


 

 

 

Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk