search

Refund ARN Notification

Use Case

This webhook is generated after the successful receipt and reconciliation of the Acquirer Reference Number(ARN) attribute from the Acquiring Bank in the T+n  settlement file. Refund ARN is only applicable for refunds of VISA, Master & Rupay networks. To configure the URL, please Get in touch

 

The sample response for Refund ARN is shared below.

[ORDERID] => OREDRID_98765
[REFID] => REFUNDMER384617804845
[MID] => INTEGR7769XXXXXX9383
[TXNID] => 202005081112128XXXXXX68470101509706
[REFUNDID] => 202303140203384XXXXXX59549002323111
[TXNAMOUNT] => 120.00
[REFUNDAMOUNT] => 70.00
[TXNDATETIME] => 2023-02-24 15:35:33
[REFUNDDATETIME] => 2023-03-14 11:04:28
[PAYMENTMODE] => CC
[GATEWAYNAME] => HDFC
[BANKNAME] => AXIS
[ARN] => 73256633124312285716334
[RRN] => 6830672893766936005961
[CHECKSUMHASH] => 6zS7debzOy+srQBUPqfFuDl8sAm8iL95WsqcT206DehEYHJ7f+JBcGAqkl1ekozsx9wWJMTanGLpTc7HfvXHPhyUc7otX/lMl88V6QGEX64=

The parameters are briefly described below.

Response Attributes

ATTRIBUTE DESCRIPTION
ORDERID
string
OrderId passed in the transaction request
Example:OREDRID_98765
REFID
string
Merchant’s reference ID unique for every refund transaction. This is REFID for which refund status is being inquired.
Example:REFUNDMER384617804845
MID
string
Merchant ID passed in the transaction request
Example: INTEGR7769XXXXXX9383
TXNID
string
Unique payment reference number generated at paytm side the original Order ID
Example: 202005081112128XXXXXX68470101509706
REFUNDID
string
Unique refund reference number that is generated by Paytm for each valid refund request
Example: 202303140203384XXXXXX59549002323111
TXNAMOUNT
string
Payment transaction Amount
Example: 120.00
REFUNDAMOUNT
string
Amount for which refund was initiated by the merchant. It can be equal to or less than the transaction amount
Example: 70.00
TXNDATETIME
string
Timestamp of payment transaction
Example: 2023-02-24 15:35:33
REFUNDDATETIME
string
Timestamp at which merchant requested the refund
Example: 2023-02-24 15:35:33
PAYMENTMODE
string
Payment Mode used in payment
Example: CC,DC,EMI
GATEWAYNAME
string
Name of the gateway used to process the transaction. In case of Super Router, this is the payment aggregator chosen to process the transaction.
Example: HDFC
BANKNAME
string
Issuing Bank Name used in payment
Example: Axis
ARN
string

Unique Reference Number generated by the Acquirer Bank for Visa, Master and Rupay networks that indicates the settlement between the acquirer and card issuing bank is complete.

Please note ARN is 23 digit number typically starting with 3, 7 or 8 and is not the same as RRN (Retrieval Reference Number).
Example: 74056633031820896327619

RRN
string
Unique reference number generated at bank side when refund is accepted by bank and can be used by customers to inquire refund status with their respective issuing bank
Example: 308822106906
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=