Request |
The createWebWallet and updateWebWallet services have been replaced by the manageWebWallet service for Redirection or Widget mode web pages.
Introduction
The "createWebWallet" function is used to initialize the creation of virtual wallet via the web interface. Once the shoper is redirected, 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.
Request to send
The request "createWebWalletRequest" must have the following structure: Élément Description Mandatory Type Example version Payline web services version. To be valued with the latest version: see the table of versions. Yes N2 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 prohibited buyer Shopper information. Yes 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 Selecting the security mode to use for the payment transaction. SSL cf. complete list in "List of security mode". privateDataList Information on personal information. NoCondition contractNumber Yes AN50 selectedContractList No Object selectedContractList updatePersonalDetails No AN1 owner Holder Information. No Object owner languageCode
eng: EnglishNo AN6 customPaymentPageCode The personalization identifier of the merchant's web pages No AN50 1fd51s2dfs51 securityMode No AN 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://... customPaymentTemplateURL Dynamic template URL. No AN255 https://.... only contractNumberWalletList List of TPV contract wallet. No Object contractNumberWalletList