SI Parameter JSON Details

billingCycle mandatory

Billing Cycle defines whether the customer needs to be charged over Daily, Weekly basis, Monthly or Yearly basis or one time.
 

ONCE

billingInterval
mandatory

Billing Interval is closely coupled with the billingCycle field and denotes at what frequency, the subscription plan needs to be executed. For monthly subscriptions, parameter values need to be sent in the request are:

• billingCycle = MONTHLY
• billingInterval = 1
  Similarly, by keeping the following values, customer will be charged once in every 3 days:
• billingCycle = DAILY
• billingInterval = 3

• billingCycle = MONTHLY
• billingInterval = 1 

billingAmount
mandatory

The billing amount is passed in XX. XX format.
In use cases where billingCycle = ADHOC, amount passed is treated as maximum amount since billing amount and billing cycle varies as per the usage of the subscription service. 
In this case, the merchant is free to charge any amount for customer up to the amount specified in the defined subscription call. 
For UPI, billingAmount should not be more than INR 15000 as it is the maximum limit allowed for UPI currently.

INR 2000

billingCurrency
mandatory

This field must be passed as “INR”
.

INR

paymentStartDate
mandatory

The start date of the billing plan is specified in this field with the YYYY-MM-DD format.

• *Note: All the subsequent recurring transactions will be processed from this date onwards as perbillingCycleandbillingIntervalfields combination. This date acts as reference point for recurring payments.Note**: In case of UPI, send the current date here and any other value will be ignored.

2022-02-14

paymentEndDate
mandatory

The end date of the billing plan is specified in this field with the YYYY-MM-DD format.

• *Note**: Pass the correct end date to PayU. Depending upon start date and end date, number of payment iterations are internally calculated and same information is passed to acquirers or banks.

2023-01-14

siTokenRequestor
mandatory for saved cards

This is optional and is only needed before 30th September, 2022 to activate new mandate setups in a controlled manner than activating it completely on all users. This involves creating token at the time of susbcription set. You can include any of the following values::

• 1 : PayU will tokenise the card and share it in same subscription setup call with issuers for subscription setup.
• 2: PayU will do the authorization on plain card. Later, the same response will be shared to merchant.

1

remarks
optional

This field is used to provide remarks on PSP applications during the registration transaction of UPI.
 For cards and Net Banking, this parameter has no significance.
 Character limit = 50.


• *Note**: This field is applicable only for UPI.

Subscription for a year

billingLimit
optional

For UPI, this field is used to decide the period corresponding which the debit from the mandate recurring date can happen and this mandate registration date is confirmed during registration transaction of UPI.

• *Note**: This field is applicable only for UPI.
  The possible values are:
• ON = Use this parameter to deduct on a specific date
• BEFORE = Use this parameter to deduct before and on a specific date
• AFTER = Use this parameter to After and on the specific date
• *Note**: If no value is passed, ‘AFTER’ is considered by default.

ON = 2022-02-20

billingRule
optional

For UPI, this field is used to decide the limitation on the amount of recurring debit against the mandate amount which is set during registration transaction of UPI.

• *Note**: This field is applicable only for UPI.
  The possible values are:
• MAX = This is the maximum amount that a merchant can debit, that is, merchant can debit lesser or equal to this amount for a recurring transaction.
• EXACT= This the exact amount that a merchant can debit in recurring debits.

Note: If no value is passed, ‘MAX’ is considered by default.

MAX = 5000

billingDate
optional

• *Applicable for UPI only**: This field is used to decide the date/day, basis which the recurring debit should happen. This can be ignored and the debit will happen as per the start date in every cycle.

FORTNIGHTLY = 7

authpayuid
mandatory for modifying subscription with cards

This field is used only to modify an existing subscription/consent. Modification means modifying billing details like startDate, endDate, billing cycle, billing interval, billing amount.

action
mandatory for cards

This field is used to modify or delete an existing subscription.

modify
or
delete

ONCE

Used when a merchant wants to execute Split / Partial payment use cases where the partial amount is paid upfront during the Consent transaction and remaining amount needs to be paid on later.
WEEKLY is used if the merchant wants to run a bi-weekly subscription then values will be similar to the following, so the customer will be charged once in every 2 weeks.:

ADHOC

Used in use cases such as post-paid bills where there is no definite billing cycle and billing amount.

• billingInterval = Billing Interval is closely coupled with the value of “billingCycle” and denotes at what frequency, the subscription plan needs to be executed.

MONTHLY

Used for monthly subscriptions, parameter values that need to be sent in request are:

• billingCycle = MONTHLY

• billingInterval = 1

YEARLY

Used for yearly subscriptions. parameter values that need to be sent in request are:

• billingCycle = YEARLY
• billingInterval = 1

WEEKLY

Used for weekly subscriptions. Use the following values to charge the customer once every week:

• billingCycle = WEEKLY
• billingInterval = 1

DAILY

Used for daily subscriptions.
Use the following values to charge the customer once in every 3 days:

• billingCycle = DAILY

• billingInterval = 3