Skip to main content
POST /v1/payments/inquiryRefund Queries the status of a refund. Use it when you have not received the refund result for a long time, or to determine the refund status in asynchronous refund processing. If both refundId and refundRequestId are provided, refundId takes priority and refundRequestId is ignored.
Polling interval: poll once every 5 seconds, for up to 1 minute.

Request Parameters

string
Wallet-generated unique refund ID.Max length: 64 characters
string
Merchant-generated unique refund ID.Max length: 64 characters

Response Parameters

object
required
Standard result object with resultCode, resultStatus, resultMessage
string
Wallet-generated refund ID.Max length: 64 characters
string
Merchant-generated refund ID.Max length: 64 characters
object
Refund amount. See Amount.
string
Reason for the refund.Max length: 256 characters
string
Timestamp when funds were deducted from merchant, in ISO 8601 format.
string
Refund status. Values: PROCESSING, SUCCESS, FAIL
string
Refund failure reason, returned only when refundStatus is FAIL. Values: BALANCE_NOT_ENOUGH, OTHERS
string
The contribution account of this refund transaction: MPA or MRBA. Defaults to MPA if the merchant did not send it.

Result Handling

Result Codes

Sample

Request

Response