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": [...] }