Card Expiry Notification

Use Case

In case your user’s card linked to the active subscription is about to expire, Paytm will send an S2S response to the webhook configured, post which a notification can be triggered to the customer informing the expiry of the card, which has active subscription on it to as to avoid failure in payment collection. We have the flexibility of:

Notify 7 days in advance
Notify 1 day in advance
On card expiry

The sample response is mentioned below.

[CUSTID] => CUST_001
[PAYMENTMODE] => CC
[MID] => INTEGR7769XXXXXX9383
[MASKEDCARDNUMBER] => 5126********2205
[FREQUENCYUNIT] => MONTH
[MAXAMOUNT] => 1000.0
[CARDEXPIRYDATE] => 122025
[CREATEDDATE] => 2020-05-05 10:00:11
[FREQUENCY] => Day
[AMOUNTTYPE] => VARIABLE
[CUSTNAME] => Rahul
[CUSTEMAILID] => customer@example.com
[CUSTMOBILE] => 7777777777
[CHECKSUMHASH] => y5Tn02QKOQdhyYKK+uHHgNIIZOjC/XXXXjSPQRBNSrcP6DR3ejFuQ4+kQi0a8KX2txJCnQkTnUxtJhM6jImU8FU+E1GlSSK5VjMLsSm/R6w=
[SUBS_ID] => 65253

The parameters are briefly described below.

Response Attributes

ATTRIBUTE	DESCRIPTION
SUBS_ID string	SubscriptionId created for this mandate. Example: 65253
PAYMENTMODE string	Payment Mode used in payment Example: CC
MID string	Merchant ID passed in the request Example: INTEGR7769XXXXXX9383
MASKEDCARDNUMBER string	Masked card no Example: 5126********2205
FREQUENCYUNIT string	This is interval cycle Example: MONTH
MAXAMOUNT string	Maximum amount that can be deducted in a subscription request Example: 1000.0
CREATEDDATE string	Subscription create date Format: YYYY-MM-DD HH:ii:ss Example: 2020-05-05 10:00:11
CARDEXPIRYDATE string	Card Expiry Format: MMYYYY - Only for Credit/Debit Card Example: 122025
FREQUENCY string	Frequency(Related to Recurring Cycle) Example: Day
AMOUNTTYPE string	Type of Subscription Amount Example: FIX, VARIABLE
CUSTNAME string	Customer Name Example: Rahul
CUSTMOBILE string	Customer Mobile Example: 7777777777
CUSTEMAILID string	Customer Email ID Example: customer@example.com
CUSTID string	Customer Id passed by the merchant Example:CUST_001
CHECKSUMHASH string	Paytm validates the parameter values by verifying the signature comes in the request. It ensures that parameter values are not tempered. Signature string can be created by using Paytm checksum library. Example: y5Tn02QKOQdhyYKK+uHHgNIIZOjC/XXXXjSPQRBNSrcP6DR3ejFuQ4+kQi0a8KX2txJCnQkTnUxtJhM6jImU8FU+E1GlSSK5VjMLsSm/R6w=