Webservice - updateWalletRequest

S’abonner

La fonction « update Wallet » permet de mettre à jour un portefeuille virtuel.

Lorsque les données du moyen de paiement sont renseignées, Payline réalise un contrôle monétique du moyen de paiement pour le valider et met à jour le portefeuille. Pour ne pas modifier le moyen de paiement, veuillez ne pas renseigner les champs « Wallet.card ».

La mise à jour est rejetée dans les cas suivants :

  • L’identifiant du portefeuille virtuel n’existe pas sur le point de vente indiqué
  • La date d’expiration de la carte est dépassée
  • Le résultat du contrôle monétique de la carte de paiement est un refus
  • Les informations obligatoires ne sont pas renseignées
  • L’authentification 3DSecure a échoué

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 code ou numéro de votre contrat VAD qui représente le moyen de paiement que vous souhaitez utiliser

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’
walletInformation sur le portefeuilleouiwallet objectVoir ci-dessous les éléments

buyer

Information sur l’acheteur

non

Object - buyer

Voir 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

authentication3DSecure

Information sur les opérations 3DSecure

non

Object - authentication3DSecure

Voir 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

contractNumberWalletListcontractNumberWalletListnonObject - contractNumberWalletListvoir ci-dessous les éléments

 

Les éléments de référence


Object wallet

Erreur du rendu de la macro 'excerpt-include' : No link could be created for 'wallet object'.

 

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 authentication3DSecure


Field

Description

Mandatory

Type

Example

Condition

md

Referred to POST by ACS

No

AN20



pares

Referred to POST by ACS

No

AN



xid

Unique transaction identifier

No

AN20



eci

Electronic Commerce Indicator. To pass in the authorization

No

AN2



cavv

Cardholder Authentication Verification Value determined by the ACS.

No

AN28



cavvAlgorithm

Positive integer specifying the algorithm used for CAVV generation. The current possible values ​​are:

0 = HMAC (SET ™ TransStain), 
1 = CVV, 
2 = CVV with ATN, 
3 = AAV MasterCard

W = Cryptogram generated by a Wallet solution

No

N1


W : Wallet UEP

vadsResult

Summary of 3DSecure operations in hexadecimal. This field is no longer used.

No

AN8



typeSecurisationField used as information for authentication.This field is no longer used.NoAN102020 :  VADS
else  9 : VAD
PaResStatus

To use a non-Payline MPI, you must fill in this field.

Values ​​are: 
Y: Successful authentication 
N: Erroneous authentication 
A: Planned passage through ACS 
U: Call to ACS performed 
empty: Time out on ACS

NoAN1

VeResStatus

To use a non-Payline MPI, you must fill in this field.

Values ​​are: Y / N / U or empty

NoAN1

 

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

Réponse en retour

Le message « updateWalletResponse » est la réponse faite par Payline à une demande de modification d’un portefeuille virtuel. La réponse a la même structure que le message  « createWalletResponse »

Élément

Description

Requis

Format

Exemple

Condition

result

Information sur le résultat de la demande de mise à jour du wallet :
02500 : operation successfull
02501 : Operation Successfull with warning
02502 : Wallet with the same identifier exist
02503 : Wallet does not exist
02511 : Wallet is not supported for this card
02101 : Internal Error

oui

Object result

02500

Voir ci-dessous les éléments


card

Information sur la carte

non

Object - cardOut

Voir ci-dessous les éléments


extendedCard

Information supplémentaire sur la carte

nonObject - extendedCardType

Voir ci-dessous les éléments


contractNumberWalletList

Un tableau des numéros de contrat du wallet

nonObject - contractNumberWalletList

Voir ci-dessous les éléments



Les éléments de référence

Object result

Erreur du rendu de la macro 'excerpt-include' : No link could be created for 'Object result'.


Object cardOut


Field

Description

Mandatory

Format

Example

Condition

number

Card marked according to PCI DSS

non

AN

111122XXXXXX4444

If the token field is populated, the number field must be empty.

type

Type of card: CB, VISA, MASTERCARD, MAESTRO, AMEX

non

AN

CB


expirationDate

Expiration date of the card

non

AN

0311


cardholder

Cardholder's name

non

AN20

Pierre Dupont


token

Alias ​​of the card number.

The version must be greater than or equal to 3

non

AN19

1111gPNzHtyu4444



Object extendedCardType


Field

Description

Mandatory

Example

country

Card country issuer : CODE ISO 

AN2

FR

isCvd

The card is it a Carte Bleue : Y or N

AN1

Y

bank

The bank of the card used for payment

AN

Crédit Lyonnais

type

The type of payment card

AN20

MASTERCARD

network

Refers to attachment of card to an entity managing the acceptance of card at national or international level

AN20

MASTERCARD

product

Indicates the category to which the card type belongs: see product codes

AN

Gold/Premier


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