FieldDescriptionRequiredFormatExampleCondition

firstAmount

The amount of the first amount to be made. It must be formulated in the smallest unit of the currency.
For an amount of 100 €, you must set the value 10000

No

N12

10000

value mandatory REC and NX

amount

The amount of a maturity. It must be formulated in the smallest unit of the currency.
For an amount of 5 €, you must put the value 500

Yes

N12

500

value mandatory REC and NX

billingCycle

The code of the frequency of payments. Values : 

40: Monthly 
60: Quarterly

cf. complete list in annex table "  Frequency list "

Yes

N2

40


billingLeftNumber total of due dates (only for NX)NoN33value mandatory NX
billingRank

Rank of the installment (from 1 to n, where n is the total number of installments ie the value of 'billingLeft')

This value has to be set when used in the doAuthorization web service

NoN21Version 22 or higher (3DSV2)
billingDayDay when the deadlines must be processed. Format : ddNoAN220

startDate

The date of the first expiry (only in REC mode). If this field is not filled in, Payline assigns the current date.
Format : dd/mm/yyyy

No

AN10

01/01/2018


endDateThe date of the end of payment deadlines.  Format : dd/mm/yyyy HH24:MINoAN16

31/12/2018 12:00


newAmountNew amount changed. For an amount of 60 €, you must put the value 6000
NoN126000
amountModificationDateThe date of the modification of the amount. Format : dd/mm/yyyy HH24:MINoAN16

06/06/2018 12:00



Example :

Payment in = REC mode with the following values:

  • recurring.billingCycle = 40 (monthly)
  • a CB card
  • 24 months with disbursements at the end of every month 
  • recurring.billingDay=31
  • recurring.EndDate = today's date +2 years

The first transaction is made on the current date and then every month, at the end of the month for 2 years until the endDate.

For the even months and the month of February, the day selected when creating the deadlines is 30 for even months and 28 or 29 for February.