post https://test.payu.in/merchant/postservice.php
API Command: check_action_status
The check_action_status API has another usage too. For a particular PayUID, it returns any of the following the states:
- QUEUED : This indicates that the refund is accepted by PayU, but not sent to the downstream banking partner for processing.
- SUCCESS : This indicates that the refund is processed successfully.
- FAILURE : This indicates that refund processing failed. No funds are deducted for such refunds from the merchant’s settlement.
- IN PROGRESS : This indicates that the refund is raised to the bank for processing.
- REQUESTED : This indicates that the refund is sent to the bank for offline processing. In such cases, it takes upto 5-7 business days for the credit to reflect into the customer’s account.
- PENDING: This indicates that the Overdraft has occurred( Insufficient funds in account ) In such cases, it takes upto 5-7 business days for the credit to reflect into the customer’s account.
Environment
| Test Environment | https://test.payu.in/merchant/postservice?form=2 |
| Production Environment | https://info.payu.in/merchant/postservice?form=2 |
Reference information for request parameters
| Parameter | Reference |
|---|---|
| key | For more information on how to generate the Key and Salt, refer to any of the following: - Production: Generate Merchant Key and Salt - Test: Generate Test Merchant Key and Salt |
| hash | Hash logic for this API is:sha512(key|command|var1|salt)
sha512 |
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=JP***g&command=check_action_status&var1=403993715521937565&var2=payuid&hash=81bdb5b8e625f254398d744269844fc6b9d87b3782670331c2a6b856f42f315b9898f397df7292cfd33a6153abf4acac58ce3ac671e41999ff81d98ce432f48e"
Failure scenarios
- If mihpayid is not found, the response is similar to the following:
{
"status": 0,
"msg": "0 out of 1 Transactions Fetched Successfully",
"transaction_details": {
"13127842": "No action status found"
}
}
- If mihpayid is missing, the response is similar to the following:
{
"status": 0,
"msg": "Parameter missing"
}
Sample response
On successful processing from PayU, the response is similar to the following:
{
"status": 1,
"msg": "1 out of 1 Transactions Fetched Successfully",
"transaction_details": {
"403993715521937565": {
"131278418": {
"mihpayid": "403993715521937565",
"bank_ref_num": "399900",
"request_id": "131278418",
"amt": "100.00",
"mode": "CC",
"action": "capture",
"token": "",
"status": "SUCCESS",
"bank_arn": null,
"settlement_id": null,
"amount_settled": null,
"UTR_no": null,
"value_date": null,
"refund_mode": "-"
},
"131278422": {
"mihpayid": "403993715521937565",
"bank_ref_num": "527013524405",
"request_id": "131278422",
"amt": "10.00",
"mode": "CC",
"action": "refund",
"token": "RefundToken1",
"status": "success",
"bank_arn": null,
"settlement_id": null,
"amount_settled": null,
"UTR_no": null,
"value_date": null,
"refund_mode": "Back to Source"
},
"131278430": {
"mihpayid": "403993715521937565",
"bank_ref_num": "527013524405",
"request_id": "131278430",
"amt": "10.00",
"mode": "CC",
"action": "refund",
"token": "RefundToken2",
"status": "success",
"bank_arn": null,
"settlement_id": null,
"amount_settled": null,
"UTR_no": null,
"value_date": null,
"refund_mode": "Back to Source"
},
"131278458": {
"mihpayid": "403993715521937565",
"bank_ref_num": "527013524405",
"request_id": "131278458",
"amt": "10.00",
"mode": "CC",
"action": "refund",
"token": "RefundToken3",
"status": "success",
"bank_arn": null,
"settlement_id": null,
"amount_settled": null,
"UTR_no": null,
"value_date": null,
"refund_mode": "Back to Source"
},
"131278471": {
"mihpayid": "403993715521937565",
"bank_ref_num": "527013524405",
"request_id": "131278471",
"amt": "10.00",
"mode": "CC",
"action": "refund",
"token": "RefundToken4",
"status": "success",
"bank_arn": null,
"settlement_id": null,
"amount_settled": null,
"UTR_no": null,
"value_date": null,
"refund_mode": "Back to Source"
},
"131278484": {
"mihpayid": "403993715521937565",
"bank_ref_num": "527013524405",
"request_id": "131278484",
"amt": "10.00",
"mode": "CC",
"action": "refund",
"token": "RefundToken5",
"status": "success",
"bank_arn": null,
"settlement_id": null,
"amount_settled": null,
"UTR_no": null,
"value_date": null,
"refund_mode": "Back to Source"
},
"131278499": {
"mihpayid": "403993715521937565",
"bank_ref_num": "527013524405",
"request_id": "131278499",
"amt": "10.00",
"mode": "CC",
"action": "refund",
"token": "RefundToken6",
"status": "success",
"bank_arn": null,
"settlement_id": null,
"amount_settled": null,
"UTR_no": null,
"value_date": null,
"refund_mode": "Back to Source"
},
"131278515": {
"mihpayid": "403993715521937565",
"bank_ref_num": "527013524405",
"request_id": "131278515",
"amt": "10.00",
"mode": "CC",
"action": "refund",
"token": "RefundToken7",
"status": "success",
"bank_arn": null,
"settlement_id": null,
"amount_settled": null,
"UTR_no": null,
"value_date": null,
"refund_mode": "Back to Source"
},
"131287648": {
"mihpayid": "403993715521937565",
"bank_ref_num": "527013524405",
"request_id": "131287648",
"amt": "10.00",
"mode": "CC",
"action": "refund",
"token": "RefundToken8",
"status": "success",
"bank_arn": null,
"settlement_id": null,
"amount_settled": null,
"UTR_no": null,
"value_date": null,
"refund_mode": "Back to Source"
},
"131295795": {
"mihpayid": "403993715521937565",
"bank_ref_num": "527013524405",
"request_id": "131295795",
"amt": "10.00",
"mode": "CC",
"action": "refund",
"token": "RefundToken9",
"status": "success",
"bank_arn": null,
"settlement_id": null,
"amount_settled": null,
"UTR_no": null,
"value_date": null,
"refund_mode": "Back to Source"
},
"131297379": {
"mihpayid": "403993715521937565",
"bank_ref_num": "527013524405",
"request_id": "131297379",
"amt": "10.00",
"mode": "CC",
"action": "refund",
"token": "RefundToken10",
"status": "success",
"bank_arn": null,
"settlement_id": null,
"amount_settled": null,
"UTR_no": null,
"value_date": null,
"refund_mode": "Back to Source"
}
}
}
}
Response parameters
The transaction_details parameter of the response is in JSON format. For more information, refer to Additional Info for General APIs.
Request parameters
Response parameters
| Parameter | Reference |
|---|---|
| key | For more information on how to generate the Key and Salt, refer to any of the following: - Production: Generate Merchant Key and Salt - Test: Generate Test Merchant Key and Salt |
| hash | Hash logic for this API is:sha512(key|command|var1|salt)
sha512 |
Example values
Use the following sample values while trying out the API:
var1(mihpayid): 403993715521937565var2: payuid