Refund Status API for Split Payments

API Command: aggregator_check_action_status_txnid

The aggregator_check_action_status_txnid API helps you to fetch the refund status of transactions where the refunds are for split payments.

📘

Note:

The aggregator_check_action_status_txnidmust be used only to check the split transactions’ refund status.

HTTP Method: POST

Environment

Request parameters

ParameterDescriptionExample
key
mandatory
string Generated by PayU while onboarding.Your Test Key
command
mandatory
string API Command for this API is aggregator_check_a
ction_status_txnid
aggregator_check_a
ction_status_txnid
hash
mandatory
hash Has generated using the following logic:
sha512(key|command|var1|salt) sha512 is the encryption method used here.
 
var1
mandatory
stringPayU ID of the transaction143034342

The valid values for subvention_mode are listed in the following table:

Refund modeValueDescription
Source1Refunds with Normal or to card
 
UPI2Refunds with UPI method
IMPS3Refunds with IMPS method
NEFT4Refunds with NEFT method

Sample request

curl -X POST "https://test.payu.in/merchant/postservice?form=2
-H "accept: application/json" -H "Content-Type: application/x-www-form-urlencoded" -d

"key=A6lB8r&command=aggregator_check_a
ction_status_txnid&hash=2a04a44ed058ca724a17b4e4d4639aa15254a343e047c9085687810d815845aed5183ae7792adbc8c9c4991f978ee2f15ea4284706dfa3fbcd42d36491369848&var1=14370578416"

Response parameters

ParameterDescription
request_idThe unique reference number of the refund request is returned in this parameter.
subvention-refund_statusThe status of Subvention refund is returned with any of the following:
mihpayidThe transaction reference number provided by PayU.
msgThe message statement is returned in this parameter.
txn statusThe current status of the transaction for the given token is returned in this parameter.
amountThe amount of the transaction for the given token is returned in this parameter.

Sample response

  • When original transaction refunds are not initiated:
{"5XAPG8":{"subvention_refund_status":0,"msg":"Please initiate or get
processed the original refund of this
transaction."},"73gAMf":{"subvention_refund_status":0,"msg":"Please
initiate or get processed the original refund of
this transaction."},"mihpayid":"999000000001122"}
  • When an invalid subvention amount is refunded is requested
{"5XAPG8":{"subvention_refund_status":0,"msg":" Subvention Amount is
invalid"},"73gAMf":{"subvention_refund_status":0,"msg":" Subvention
Amount is invalid"},"mihpayid":"999000000001122"}
  • Response for successful queued subvention refund:
{"5XAPG8":{"subvention_refund_status":1,"msg":"Subvention refund will be
processed.","request_id":"698"},"73gAMf":{"subvention_refund_status":1,"
msg":"Subvention refund will be
processed.","request_id":"699"},"mihpayid":"999000000001122"}
  • When an invalid subvention mode is requested:
{"5XAPG8":{"subvention_refund_status":0,"msg":"Invalid Subvention Mode
Received"},"73gAMf":{"subvention_refund_status":0,"msg":"Invalid
Subvention Mode
Received"},"mihpayid":"999000000001122"}
  • When proper beneficiary details are not passed:
{"5XAPG8":{"subvention_refund_status":0,"msg":"Beneficiary details
missing required for Subvention
Refund."},"73gAMf":{"subvention_refund_status":0,"msg":"Beneficiary
details missing required for Subvention
Refund."},"mihpayid":"999000000001122"}