Outgoing Money from a Customer
This callback is given when the customer pays
- for his merchant order using Collect Approve
- for his merchant order using the SDK Pay
- to another UPI user by using Collect Approve
- to another UPI user using vpa, A/C+IFSC, Scan&Pay, Intent
Note: Merchant can get multiple callbacks for the same event type till the transaction status reaches a terminal state. Terminal states for a transaction are SUCCESS, FAILURE, EXPIRED, DECLINED.
The possible ‘type’ values are mapped as follows -
CUSTOMER_DEBITED_FOR_MERCHANT_VIA_COLLECT - Outgoing money from a customer to merchant via collect
CUSTOMER_DEBITED_FOR_MERCHANT_VIA_PAY - Outgoing money from a customer to merchant via pay
CUSTOMER_DEBITED_VIA_COLLECT - Outgoing money from a customer to a UPI user via collect
CUSTOMER_DEBITED_VIA_PAY - Outgoing money from a customer to a UPI user via pay
|
Parameter
|
Description
|
|---|---|
amount
| Amount for which customer made the payment.
|
autoUpdateNote (optional)
| adjFlag and adjCode separated by "|"
|
bankAccountUniqueId (optional)
| Unique hash for the customer bank account used for transaction. Only if gatewayResponseCode is non "U69".
|
bankCode (optional)
| IIN for the customer bank account used for transaction. Only if gatewayResponseCode is non "U69".
|
customResponse
| Stringified JSON parameter for future use.
|
gatewayPayerResponseCode (optional)
| Response code returned by gateway
|
gatewayPayeeResponseCode (optional)
| Response code returned by gateway
|
gatewayPayerReversalResponseCode (optional)
| Response code returned by gateway
|
gatewayPayeeReversalResponseCode (optional)
| Response code returned by gateway
|
gatewayReferenceId
| Customer reference number (rrn) for the transaction.
|
gatewayResponseCode
| Response code returned by gateway for the transaction. Refer below.
|
gatewayResponseMessage
| Verbose response message returned by gateway for the transaction.
|
gatewayResponseStatus
| Response status returned by gateway
|
gatewayTransactionId
| UPI request id returned by gateway for the transaction.
|
maskedAccountNumber (optional)
| Masked account number for the customer bank account used for transaction. Only if gatewayResponseCode is non "U69".
|
merchantChannelId
| Unique id for the channel via which request is made.
|
merchantCustomerId
| Merchant generated unique id for customer who sent the payment.
|
merchantId
| Unique id for merchant.
|
merchantRequestId (optional)
| Merchant generated request id as passed in the collect request. Only if gatewayResponseCode is not "U69". Only given to the party which initiates the transaction
|
orgMandateId (optional applicable only for collect mandate)
| Refers to upiRequestId used during creation of mandate.
|
payeeMcc
| Merchant Category Code of the payee merchant.
|
payeeMerchantCustomerId (optional)
| Merchant generated unique id for customer who received the payment. Only if it is an onus P2P transaction.
|
payeeName (optional)
| Name of the upi user who received the payment. Only if payment is done to a non A/C+IFSC vpa.
|
payeeVpa
| Vpa of the upi user who received the payment.
|
payerMerchantCustomerId
| Merchant generated unique id for customer who sent the payment.
|
payerMobileNumber
| Mobile number of the customer who made the payment.
|
payerVpa
| If collectType is null or TRANSACTION, Vpa of the customer who received the collect request and if collectType is MANDATE, umn of the mandate.
|
payeeAcType
| Account type of the merchant who receives the payment.
|
payeeIfsc
| Account's ifsc of the merchant who received the payment.
|
requestType (optional)
| Action which was taken on the collect request. Will not be present in case of EXPIRED callback.
|
collectType (optional)
| Differentiates between a transaction collect request (TRANSACTION) or a mandate execution collect request (MANDATE). It will only be present in case of mandate request.
|
seqNumber (optional applicable only for collect mandate)
| Denotes the recurring cycle of mandate execution. Will be received only during mandate executions. It will only be present in case of mandate request.
|
refUrl
| Invoice as sent by merchant or reference to the transaction in the form of url.
|
riskScore (optional)
| RiskScore shared by NPCI or Bank
|
transactionTimestamp
| Timestamp of when the payment was received. (YYYY-MM-DDTHH:MM:SS+05:30)
|
transactionType
| P2M_PAY, P2P_PAY, SCAN_PAY, INTENT_PAY, P2PM_PAY, SELF_PAY, LITE_PAY, INTERNATIONAL_PAY
|
type
| Event type of the callback. Refer above Note.
|
udfParameters (optional)
| Udf parameters as passed in the original payment request.
|
umn (optional applicable only for collect mandate)
| Vpa used for execution of mandate.
|

