POST /v1/payments/refundApply
Applies for a refund. After a successful response (resultStatus: S), use inquiryRefund to verify the actual refund state.
Request Parameters
Merchant-generated unique refund ID (idempotency key).Max length: 64 characters
Wallet-generated ID of the original payment.Max length: 64 characters
Merchant-generated ID of the original payment request.Max length: 64 characters
Wallet-generated capture request ID (for captured payments).Max length: 64 characters
Reason for the refund.Max length: 256 characters
JSON-formatted extension data. May include
contributionAccount, refundNotificationUrl, latitude, longitude, transactionAddress.Max length: 2048 charactersResponse Parameters
Standard result object with
resultCode, resultStatus, resultMessageWallet-generated unique refund order number. Present when
resultStatus is S.Result Codes
| resultStatus | resultCode | Description |
|---|---|---|
S | SUCCESS | Refund request accepted |
F | PARAM_ILLEGAL | Invalid parameters |
F | PROCESS_FAIL | Processing failed |
F | MULTI_REFUND_NOT_ALLOWED | Multiple refunds not permitted |
F | REFUND_NOT_ALLOWED | Refunds not allowed for this order |
F | REPEAT_REQ_INCONSISTENT | Inconsistent duplicate request |
F | PARTNER_STATUS_ABNORMAL | Partner status issue |
F | ORDER_NOT_EXIST | Order does not exist |
F | ORDER_STATUS_INVALID | Invalid order status |
F | REFUND_WINDOW_EXCEED | Refund window exceeded |
F | REFUND_AMOUNT_EXCEED | Total refund exceeds payment amount |
F | CURRENCY_NOT_SUPPORT | Currency not supported |
U | UNKNOWN_EXCEPTION | Unknown error occurred |