Skip to main content
POST /v1/payments/refundApply Applies for a refund. After a successful response (resultStatus: S), use inquiryRefund to verify the actual refund state.

​
Request Parameters

​
refundRequestId
string
required
Merchant-generated unique refund ID (idempotency key).Max length: 64 characters
​
refundAmount
object
required
Refund amount with currency in smallest units. See Amount.
​
paymentId
string
Wallet-generated ID of the original payment.Max length: 64 characters
​
paymentRequestId
string
Merchant-generated ID of the original payment request.Max length: 64 characters
​
captureId
string
Wallet-generated capture request ID (for captured payments).Max length: 64 characters
​
refundReason
string
Reason for the refund.Max length: 256 characters
​
extendInfo
string
JSON-formatted extension data. May include contributionAccount, refundNotificationUrl, latitude, longitude, transactionAddress.Max length: 2048 characters

​
Response Parameters

​
result
object
required
Standard result object with resultCode, resultStatus, resultMessage
​
refundId
string
Wallet-generated unique refund order number. Present when resultStatus is S.

​
Result Codes