UPI Payments Webhooks

UPI Payments Webhooks:

Below is the sample response for 3 types of events:

1. UPI PreAuth: This is a webhook for Make UPI Payment API. It comes with 15 mins delay wrt actual API, which can be used for recon and timeout handling.

2. Confirm Collect Money: This webhook is for Action Collect Payment API. This also comes with 15 mins of delay, used for recon and timeout handling.

3. Transaction Status Transition: In case of UPI payment goes to a pending state initially and after some time status gets changes from pending to failure or success, this API will help to notify clients about the change in status.

{
 "rrn": "g23eg32878723eh329e8923",
 "status": "Success",
 "merchant": {
 "upi_merchant_id": "upi_txn_id361639163861",
 "merchant_vpa": "amazon@okhdfc",
 "merchant_name": "amazon",
 "mcc": "1234"
 },
 "txn_logs": [
 {
 "entry_id": "ent_b3c8475d76b346b5b47d62a0fe329bc5",
 "txn_log_id": "txn_b3c8475d76b346b5b47d62a0fe329bc5",
 "account_id": "acc_db7ca20c268045f6bcdb27af064c19c4",
 "txn_date": "2018-02-28T10:30:38+05:30",
 "txn_type": "UPI_FUND",
 "txn_code": "UPI_PAYMENT",
 "txn_indicator": "Debit",
 "txn_amount": 100,
 "txn_currency": {
 "alpha_code": "INR",
 "numeric_code": 356
 },
 "remarks": "Paying for Groceries",
 "rrn": "493dceaf-17c3-44dd-8414-be0ce6635d1a"
 }
 ]
 "funding_account_balance": [
 {
 "currency": "INR",
 "balance": 100
 }
 ],
 "target_account_balance": [
 {
 "currency": "INR",
 "balance": 100
 }
 ],
}

Field Name	Data Type	Required (O/M)	Description
rrn	String	M	Retrieval Reference Number
status	String	M	Status of the UPI Payments. Possible Values: “success”, “pending” and “failed”
upi_merchant_id	String	M	UPI Merchant Id against which payment happend
merchant_vpa	String	O	VPA of the merchant
merchant_name	String	O	Name of the merchant
mcc	String	O	Merchant Category Code
entry_id	String	M	Unique reference to the entry of the transaction
account_id	String	M	Account Id of the user
txn_type	String	M	Refer below for more details
txn_log_id	String	M	Unique reference to the transaction
txn_code	String	M	Code of Transaction
txn_indicator	String	M	Define Credit or Debit
txn_date	String	M	Transaction Date time stamp
remarks	String	O
txn_amount	Numeric	M	Transaction Amount
txn_currency	String	M	Transaction Currency
target_account_balance	List	O
funding_account_balance	List	O