Skip to main content
POST /v1/payments/inquiryRefund Queries the status of a refund. Use when the refund result cannot be obtained after extended delays. If both refundId and refundRequestId are provided, refundId takes priority.

​
Request Parameters

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

​
Response Parameters

​
result
object
required
Standard result object with resultCode, resultStatus, resultMessage
​
refundId
string
Wallet-generated refund ID.Max length: 64 characters
​
refundRequestId
string
Merchant-generated refund ID.Max length: 64 characters
​
refundAmount
object
Refund amount. See Amount.
​
refundReason
string
Reason for the refund.Max length: 256 characters
​
refundTime
string
Timestamp when funds were deducted from merchant, in ISO 8601 format.
​
refundStatus
string
Refund status. Values: PROCESSING, SUCCESS, FAIL
​
contributionAccount
string
Account type. Values: MPA, MRBA. Defaults to MPA.

​
Result Codes

resultStatusresultCodeDescription
SSUCCESSQuery successful; check refundStatus for actual state
FPARAM_ILLEGALInvalid parameters
FREFUND_NOT_EXISTRefund not yet accepted or does not exist
UUNKNOWN_EXCEPTIONUnknown error occurred