Webservice - createWalletRequest

S’abonner

La fonction « createWallet » permet de créer un portefeuille virtuel pour votre client. Afin de valider l’utilisation du portefeuille, Payline réalise un contrôle monétique du moyen de paiement par une transaction d’autorisation à 1 euro qui ne sera pas validée (pas de paiement réel).

Dans le cas où vous possédez plusieurs points de vente sur un même compte commerçant, le portefeuille sera associé au point de vente précisé lors de la demande de création.

La création est rejetée dans les cas suivants :

  • L’identifiant du portefeuille virtuel fourni n’est pas unique
  • 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
walletInformation sur le portefeuilleouiwallet objectVoir les éléments ci-dessous

buyer

Information sur l’acheteur

non

Object - buyer

Voir les éléments ci-dessous

ownerInformation sur le titulairenonObject - ownerVoir les éléments ci-dessous

privateDataList

Information sur les informations personnelles

non

Object PrivateDataList

Voir les éléments ci-dessous

authentication3DSecure

Information sur les opérations 3DSecure

non

Object - authentication3DSecure

Voir les éléments ci-dessous

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

contractNumberWalletListListe des contrats du portefeuillenonObject - contractNumberWalletListVoir les éléments ci-dessous


Il est possible d'appeler createWallet avec des données carte encryptées via l'API AJAX (token PAN et virtual CVV). Dans ce cas, la référence commande passée initialement à la servlet getToken de l'API AJAX doit être précisée dans la trame d'appel à createWallet via une donnée privée portant la clef refWeb2Token.

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 « createWalletResponse » est la réponse faite par Payline à une demande de création d’un portefeuille virtuel. La réponse a la structure suivante :


Élément

Description

Requis

Format

Exemple

Condition

result

Information sur le résultat de la demande de création de wallet :

00000 : Transaction approved
023xx : Invalid Transaction
02500 : operation sucessfull
02502 : Wallet with the same identifier 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


fraudResultDetailsInformation sur le résultat de la fraudenonObject - fraudResultDetailsVoir ci-dessous les éléments


Les éléments de référence

Object Result


Field

Description

Format

Condition

code

The return code of the web service: See details of Payline Return Codes

Accepted transaction: 00000, 02400, 02500, 02501, 02517, 02520, 02616, 03000, 04000.
Other code: Transaction not accepted.

N5


shortMessage

Short message of the result of the transaction. See the list of values

AN50


longMessage

Message of the result of the transaction

AN255


partnerCodeReturn code from partner (payment method) and SAA acquirerAN50From version 14
partnerCodeLabelPartner's wordingAN255From version 14


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


Object fraudResultDetails


FieldDescriptionFormatExample
code

Return code of the web service.

00000: Transaction approved
01xxx: Transaction refused
021xx: Internal Error
cf. complete list in the appendix table "Return codes"

N5

00000

shortMessageMessage court du résultat de la transactionAN50ACCEPTED
longMessageMessage du résultat de la transactionAN255Transaction approved





Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk