Request

Response




Request 

The createWallet function allows you to create a virtual wallet for your client. In order to validate the use of the wallet, Payline carries out a monetary control of the payment method by a 1 euro authorization transaction that will not be validated (no real payment).

In the case where you have several points of sale on the same merchant account, the portfolio will be associated with the point of sale specified during the creation request.

Creative is rejected in the following cases :

  • The identifier of the virtual wallet provided is not unique
  • Expiry date of the card is exceeded
  • The result of the electronic control of the payment card is a refusal
  • Required information is not filled
  • 3DSecure authentication failed



Element

Description

Required

Format

Example

version

Payline web services version. To be valued with the latest version: see the table of versions.

Yes

N2

18

contractNumber

The code or number of your VAD contract that represents the payment method you want to use.

YesAN50
walletWallet information.YesObject wallet

buyer

Buyer information.

No

Object buyer


ownerCardholder information.NoObject owner

privateDataList

Personal information.

No

Object PrivateDataList


authentication3DSecure

3DSecure operations information.

No

Object authentication3DSecure


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

contractNumberWalletListList of wallet contracts.NoObject contractNumberWalletList
transactionIDUnique Payline transaction identifier : use it instead of tokenCard.No


You can use createWallet service with encrypted card data via the AJAX API (PAN token and virtual CVV). 
In this case, the order reference initially passed to the getToken servlet of the AJAX API must be specified in the call frame to createWallet via a private data bearing the refWeb2Token key .