Skip to main content
POST /v1/payments/refundApply Initiates a full or partial refund of a successful payment, returning money to the payer. Rebell determines whether the refund can be made from the payment status and responds to the merchant. After a successful response (resultStatus: S), use inquiryRefund to verify the actual refund state.
  • Multiple refunds are supported for one successful payment, but the total refunded amount cannot exceed the payment amount.
  • refundAmount.currency must be the same as the currency of the original payment.
  • At least one of paymentId, paymentRequestId or captureId must be provided so that Rebell can find the original payment.
  • All monetary values are in the smallest currency unit (euro cents): 150 EUR is sent as 15000.

Request Parameters

string
required
Merchant-generated unique refund ID. Used for idempotency control: requests with the same refundRequestId that reached a final status (S or F) return the same result.Max length: 64 characters
object
required
Refund amount with currency in smallest units. See Amount.
string
Wallet-generated ID of the original payment.Max length: 64 characters
string
Merchant-generated ID of the original payment request.Max length: 64 characters
string
Wallet-generated capture request ID (for captured payments).Max length: 64 characters
string
Reason for the refund.Max length: 256 characters
string
JSON-formatted extension data:Max length: 2048 characters

Response Parameters

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

Result Handling

Result Codes

Sample

Request

Response