The "createWebWallet" function is used to initialize the creation of virtual wallet via the web interface. Once the creztion is dislayed, the shopper will be prompted to enter his card information to create his virtual wallet. Payline checks this information with a debit authorization request for an amount of only one euro (validation does not take place, so no credit card is credited at the time of creation) and records your customer's wallet with the customer. identifier (walletID) that you provided.
It is necessary that the TPV contract provided by the bank, authorizes the merchant to be able to make payments without cryptogram or to obtain a TPV contract authorizing to make recurring payments.
This functionality will allow, starting from the V4.31 release, delivered in October 2012, the cards management of shopper wallet. Your shopper will be able to:
- consult the card (s) registered on his wallet;
- delete a card registered on his wallet;
- add a card in his wallet;
- Set as a default payment method a card from his wallet.
The createWebWallet and updateWebWallet services have been replaced by the manageWebWallet service for Redirection or Widget mode web pages.
Request to send
The request "createWebWalletRequest" must have the following structure:
Payline web services version. To be valued with the latest version: see the table of versions.
The code or number of your TPV contract that represents the means of payment you want to use.
The list of contract numbers you want to use for this payment. Payline displays the list of payment methods in the order in which the list has been filled.
If this field is not filled in, Payline displays all of your active means of payment at the point of sale.
If only one contract is filled, Payline displays a page for entering bank details.
If 2 or more contracts are indicated, Payline displays a payment methods selection page
Indicator of possibility of updating the personal data by the holder of the portfolio.
Empty: Update prohibited
0: Update prohibited1: Update allowed.
|owner||Holder Information||No||Object owner|
Fill in this field with the ISO code of the language in which you want to display the Payline payment web pages. By default, the web browser of your shopper asks Payline for the page in the desired language.
fre : French
|customPaymentPageCode||The personalization identifier of the merchant's web pages||No||AN50||1fd51s2dfs51|
Selecting the security mode to use for the payment transaction.
cf. complete list in "List of security mode"
|returnURL||URL on which the shopper's browser is redirected after validation of payment on Payline.||Yes||AN255||http://... or https://...|
|cancelURL||URL on which the shopper's browser is redirected if he decides not to validate the payment or that Payline can not authorize the payment of this customer.||Yes||AN255||http://... or https://...|
|notificationURL||URL on which Payline will ask the merchant site to retrieve the result of the transaction.||No||AN255||http://... or https://...|
Information on personal information
|customPaymentTemplateURL||Dynamic template URL||No||AN255||https://.... only|
|contractNumberWalletList||List of TPV contract wallet||No||Object contractNumberWalletList|