Refund

This API is used to initiate the refund of a successful forward order.

API Host

EnvironmentHttp MethodAPI Host URL
SandboxPOSThttps://api-preprod.phonepe.com/apis/pg-sandbox/payments/v2/refund
ProductionPOSThttps://api.phonepe.com/apis/pg/payments/v2/refund

Request Headers

Header NameHeader ValueMandatoryDescription
Content-Typeapplication/jsonYes
AuthorizationO-Bearer <access_token>YesPass access_token received in Authorization call

Request Parameters

Parameter NameTypeDescription
merchantRefundIdStringUnique merchant refund id generated by merchant
originalMerchantOrderIdStringOriginal merchant order id against which refund is required
amountLongAmount in paisa to refund

Sample Request

{ "merchantRefundId": "Refund-id-12345", "originalMerchantOrderId": "Order-12345", "amount": 50000 }

Sample Response

{ "refundId": "OMRxxxxx" "amount": 50000, "state": "PENDING" }

Response Parameters

Parameter NameTypeDescription
refundIdStringPG generated internal refund id
stateStringrefund state, expected value = PENDING
amountLongAmount in paisa to refund