Modify Recurring Payments for a Card

key mandatory

varchar This parameter is the unique Merchant Key provided by PayU for your merchant account.

Your Test Key

txnid
mandatory

varchar This parameter is known as Transaction ID (or Order ID). It is the order reference number generated at your (Merchant's) end. It is an identifier that you (merchant) would use to track a particular order. If a transaction using a particular transaction ID has already been successful at PayU, the usage of the same Transaction ID again would fail. Hence, you must post us a unique transaction ID for every new transaction.
Character limit: 25

Note: Ensure that the transaction ID sent to us has not been successful earlier. In case of this duplication, the customer would get an error of 'duplicate Order ID.'

fd3e847h2

amount
mandatory

float This parameter should contain the payment amount of the particular transaction.

Note: Type-cast the amount to float type
Depending upon the merchant use case, this value will vary.

• It can be either 0 INR (for Net Banking) or min 1 INR (for Cards & UPI) in penny transaction use case.

• In the case of first instalment use cases, this amount can be equal to initiate setup amount, but this use case will be supported only against selected Net Banking (ICICI and HDFC), all Credit / Debit Cards, and UPI

1000

productinfo
mandatory

varchar This parameter should contain a brief product description. It should be a string describing the product.
Character limit: 100

Time Magazine Subscription

firstname
mandatory

varchar Must contain the first name of the customer.
Character limit: 60

Ashish

email
mandatory

varchar Must contain the email of the customer.
This information is helpful when it comes to issues related to fraud detection and chargebacks. Hence, it is a must to provide the correct information.
Also, MIS reporting is shared with few issuing banks where email and mobile number is used to keep track of users using SI transactions.
Character limit: 50

[email protected]

phone
mandatory

varchar Must contain the phone number of the customer.

This information is helpful when it comes to issues related to fraud detection and chargebacks. Hence, it is must to provide the correct information Also, MIS reporting is shared with few issuing banks where email and mobile number is used to keep track of users using SI transactions.
Character limit: 50

9843176540

api_version
mandatory

This parameter must always needs to be passed as 7.

7

si
mandatory

This parameter must be passed with the value as 2 to modify an already existing subscription/consent.

3

pg
mandatory

String This parameter defines the payment category that the merchant wants the customer to see by default on the PayU's payment page. In this example, "CC" must be specified. For more information, refer to Payment Mode Codes.

bankcode
mandatory

Each payment option is identified with a String unique bank code at PayU. The merchant must post this parameter with the corresponding payment option's bank code value in it. For more information, refer to Card Type Codes and Supported Banks for Cards

user_credentials
mandatory

String This parameter must contain the user credentials.

a:b

store_card_token
mandatory

String This must include the Network token generated at your end.

1234 4567 2456 3566

free_trial
optional

This is mandatory only if the merchant wants to support free trial use case with card and net banking together that too on PayU Hosted Checkout integration.

In this case, PayU adjusts the transaction amount as INR 2.00 for cards. INR 0.00 for Net Banking and UPI registration irrespective of what amount is passed against the amount field in the request.
This parameter has no significance in the case of seamless flow.

si_details
mandatory

This parameter represents mandatory details which need to be passed to during registration transaction from merchant system to PayU.

Note: It is mandatory as per the latest RBI guidelines to pass this information to the payment processor so that same can be forwarded to acquirers and issuers ( for more details refer – https://www.rbi.org.in/Scripts/NotificationUser.aspx?Id=11668&Mode=0 )

This is a JSON object and it includes a set of parameters are described in the the si_details Parameter Description table.

Refer the example below the si_details Parameter Description table.

hash
mandatory

Hash is a crucial parameter used to ensure that any date is not tampered while redirecting customer from the merchant website to PayU's payment interface while registration transactions.

It is SHA512 hash generated by encrypting values of merchant key, txnid, amount, productinfo, firstname, email, udf and si_details by merchant salt.

In the case of registration transaction, the formula is used to calculate this hash is similar to the following:
HASH = SHA512(key|txnid|amount|productinfo|firstname|email|udf1|udf2|udf3|udf4|udf5||||||si_details|SALT)

store_card_token mandatory

String This must include the Network token generated at your end.

1234 4567 2456 3566

storecard_token_type
mandatory

integer This parameter is used to specify the store card token type. For this scenario, you must include 1.

1

additional_info
mandatory

String This parameter will contain the additional information in the following JSON format:
{"last4Digits": "1234", "tavv": "ABCDEFGH","trid":"1234567890", "tokenRefNo":"abcde123456"}

{"last4Digits": "1234", "tavv": "ABCDEFGH","trid":"1234567890", "tokenRefNo":"abcde123456"}

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 per billingCycle and billingInterval fields 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 cancel an existing subscription. Include modify to modify a subscription.

modify