Skip to main content
POST /v2/payments/inquiryRefund Queries the current status of a refund. Use this when the refund response has an unknown status or to verify refund completion.

​
Request Parameters

​
refundId
string
Rebell refund identifier.
​
refundRequestId
string
Merchant refund request ID.
At least one of refundId or refundRequestId is required.

​
Response Parameters

​
result
object
required
Standard result object
​
refundId
string
Rebell refund identifier
​
refundRequestId
string
Merchant refund request ID
​
refundStatus
string
Current refund status:
  • SUCCESS - Refund completed
  • PROCESSING - Refund in progress
  • FAIL - Refund failed
​
refundAmount
object
Refund amount details
​
refundTime
string
Refund completion time (ISO 8601)

​
Example Request

{
  "refundId": "2024011198765432101234",
  "refundRequestId": "REFUND-20240111-001"
}

​
Example Response

{
  "result": {
    "resultCode": "SUCCESS",
    "resultStatus": "S",
    "resultMessage": "success"
  },
  "refundId": "2024011198765432101234",
  "refundRequestId": "REFUND-20240111-001",
  "refundStatus": "SUCCESS",
  "refundAmount": {
    "currency": "EUR",
    "value": "1500"
  },
  "refundTime": "2024-01-11T10:15:30+01:00"
}

​
Result Codes

resultStatusresultCodeDescription
SSUCCESSQuery successful (check refundStatus)
FREFUND_NOT_EXISTRefund not found
FPARAM_ILLEGALInvalid parameters