Webservice - getWalletRequest

S’abonner

La fonction « getWallet » récupère les données d’un portefeuille virtuel.

La requête « getWalletRequest » doit transmettre le champ walletID et contractNumber pour identifier un portefeuille.

Requête à envoyer


É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.

contractNumber

Le n° de contrat VAD qui a été utilisé pour la création du portefeuille

ouiAN50
walletIdL’identifiant du portefeuille virtuel.ouiAN50
cardInd

Spécifie l’index de la carte à utiliser dans le portefeuille. Ce champ est obligatoire si vous utilisez les multiwallet

nonN2L’index de la carte, valeur par défaut ‘01’

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


Réponse en retour


Le message « getWalletResponse » est la réponse faite par Payline à une demande de récupération des données 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 de récupération des données du wallet

02500 : operation successfull
02503 : Wallet does not exist
02504 : Invalid transaction
02511 : Wallet is not supported for this card

ouiObject 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
isDisabledIndicateur désactivation du portefeuille.

1 = Désactivé

0 = Actif
nonN11
disableDateDate la désactivation du portefeuillenonAN14Format : dd/mm/yy HH24 :MI

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
contractNumberWalletListUn tableau des numéros de contrat du walletnonObject contractNumberWalletListVoir ci-dessous les élémentsNon utilisé en mode Widget

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



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