Historique de la page

Request to send

Image Removed

Image Removed

It is imperative after the creation or the update of a WALLET, to use the webservice getWebWallet, which will guarantee you the result obtained.

The method retrieves information from a virtual wallet created via the web interface.

Request to send

The "getWebWalletRequest" request includes:

Object wallet

Element

Description

Required

Type

Example

Condition

walletId

The unique identifier of the virtual wallet. You must provide Payline with a unique identifier that corresponds to one and only one buyer on your information system. It is with this same identifier you can request a payment by virtual wallet.

Yes

AN50

lastNameThe name of the buyer. This information is useful for finding a portfolio in the Trading Administration Center.noAN100

firstName

First name of the buyer.

no

AN100

E-mail

The email address of the buyer. Payline will use this information to send a proof of payment to your customer.

no

AN150

shippingAddress

Delivery address of the buyer

no

Object address

cardBuyer card informationYesObject cardhowcommentsnoAN255defaultCard saved by defaultnoAN1Y or N: Default cardcardStatus

Possible values: 
- EXP: Date expired 
- OPP: setting opposition 
- MAN: manual deactivation 
- INT: internal rules

noAN3EXPcardBrand

Indicates the mark used for the operation:

Code

Wording

0CB1VISA4MASTERCARD5MAESTRO8BCMCIt is taken into account only if the means of payment allows the choice of the mark

Element	Description	Required	Type	Example
version	Version of Payline web services	Yes	N2	To be valued with the latest version: see the table of versions.
token	Time-stamped session token that identifies the merchant.	Yes	AN50

Answer back

The "getWebWalletResponse" message is the response of an information request from a virtual wallet.

The answer has the following structure:

Element

Description

Required

Type

Example

privateDataList

Information on personal information

no

Object PrivateDataList

See below the elements

Additional information on the map

media

Detection of the media used during the payment. 
The possible values ​​of this tag are:

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

no

AN25

Mobile

The number of attempts made by the customer during his web payment.

List of possible values: 
- 0: No payment attempt 
- 1, 2 or 3 payment attempts

A chart of the contract numbers of the wallet. 

The reference elements

Object result

code

The return code of the web service:

Accepted transaction: 00000, 02400, 02500, 02501, 02517, 02520, 02616, 03000, 04000.

Other code: Transaction not accepted

N5

See details of Payline Return Codes

ShortMessage

Short message of the result of the transaction

AN50

See the list of values

longMessage

Message of the result of the transaction

AN255

Object privateDataList

Object owner

Element

Description

Required

Type

Example

lastName

cardholder name

no

AN30

Pierre

firstName

First name of the holder

no

AN15

Paul

billingAddress

no

Object addressOwner

issueCardDate

Date of issue of the card

no

AN4

Format: mmyy

privateData

List containing privateData

Number of items 0 to 100

Object privateData

Object privateData

key

The name of the key of value

Yes

wear

value

Value associated with the key

Yes

AN50

dupond or durand, etc.

ExtendedCardType Object

Element

Comment

Required

Example

country

Country of issue of the card

AN2

ISO CODE: example FR

isCvd

The card is it a blue card

AN1

Y OR N

bank

The bank of the card used for payment

YEAR

Credit Lyonnais

type

The type of payment card

AN20

MASTERCARD

network

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

AN20

MASTERCARD

product

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

YEAR

Gold / Premier for a VISA card

Object contractNumberWalletList