Arborescence des pages

 Request

Response


The function doRecurrentWalletPayment saves a payment record for automatic and recurring billing of your customer.

Payline processes day-by-day deadlines and informs you of the result via the notification function.

The payment record is characterized by:

  • information from an existing virtual wallet ; 
  • payment deadlines: an amount, a currency, a due date, a status, etc.


The registration of the payment file is refused in the following cases:

  • The identifier of virtual wallet provided does not exist or the wallet is inactive 
  • The amount of payment.Amout field does not have the correct value 
  • The payment method is not accepted

In the event that the expiry date of credit card does not cover all the future due dates, Payline will alert you with the return code 02506.

A payment is refused only if the request for authorization is refused.

Request 

The request doRecurrentWalletPaymentRequest must have the following structure :

Element

Description

Required

Format

Condition

version

Version of Payline web services. See the table of versions.

Yes

N2


paymentPayment information.YesObject payment
orderRefOrder information.YesAN50
orderDate

Date of the order.

YesAN16
scheduledDate

The desired date for the authorization request.

YesAN10
walletId

The unique identifier of the virtual wallet. This is the identifier that you communicated during the request to create the Wallet.

YesAN50
cardInd

This field is required if you use the multi-wallet.

NoN2
cvxVisual cryptogram on the back of the credit card.NoAN10Version 27 or higher (3DSV2)
recurring

Information on deadlines.

YesObject recurring

privateDataList

Personal information.

No

Object PrivateDataList


order

Order information.

NoObject order

media

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

-       Computer,
-       Mobile,
-       Tablet,
-       TV,
-       Console,
-       Undefined.

No

AN25


authentication3DSecure3DSecure operations information.NoObject authentication3DSecureVersion 27 or higher (3DSV2)
linkedTransactionIdIn case of installment, recurring or split shippment payment refers to the first authorization (bank id).NoAN200Version 27 or higher (3DSV2)