Refund Status

This API is used to check the status of an initiated refund request.

API Path and Method

EnvironmentHttp MethodAPI Host URL
SandboxGEThttps://api-preprod.phonepe.com/apis/pg-sandbox
ProductionGEThttps://api.phonepe.com/apis/pg

API Endpoint

  • /payments/v2/refund/{merchantRefundId}/status

Request Headers

Header NameHeader ValueDescription
Content-Typeapplication/json
AuthorizationO-Bearer <access_token>Pass access_token received in Authorization call

Path Parameters

merchantRefundId : Merchant Refund Id against which the status is to be fetched.

Sample Response

Refund Failed

{
    "originalMerchantOrderId": "",
    "refundId": "OMRxxxxx",
    "amount": 1234,
    "state": "FAILED",
    "errorCode": "INTERNAL_SERVER_ERROR",
    "detailedErrorCode": "",    
    "splitInstruments": [...]
        }