Skip to main content
POST /v2/payments/void Voids a payment before it has been settled. Use this when you need to cancel a payment on the same day before the settlement batch runs.
Void is different from refund: voids cancel transactions before settlement, while refunds reverse transactions after settlement. Voids are typically faster and may avoid processing fees.

​
Request Parameters

​
paymentId
string
required
Payment identifier to void.
​
voidRequestId
string
required
Merchant-generated unique void request ID (idempotency key).Max length: 64 characters

​
Response Parameters

​
result
object
required
Standard result object
​
voidId
string
Rebell-assigned void identifier
​
paymentId
string
Original payment identifier
​
voidedTime
string
Void processing time (ISO 8601)

​
Example Request

{
  "paymentId": "2024011012345678901234",
  "voidRequestId": "VOID-20240110-001"
}

​
Example Response

{
  "result": {
    "resultCode": "SUCCESS",
    "resultStatus": "S",
    "resultMessage": "success"
  },
  "voidId": "2024011055555555501234",
  "paymentId": "2024011012345678901234",
  "voidedTime": "2024-01-10T16:45:00+01:00"
}

​
Result Codes

resultStatusresultCodeDescriptionAction
SSUCCESSPayment voidedUpdate order status
FORDER_NOT_EXISTPayment not foundVerify paymentId
FVOID_NOT_ALLOWEDPayment cannot be voidedUse refund instead
FORDER_ALREADY_SETTLEDPayment already settledUse refund instead
UVOID_IN_PROCESSVoid processingPoll with inquiryVoid

​
When to Use Void vs Refund

ScenarioUse
Same-day cancellation before settlementVoid
Cancellation after settlementRefund
Partial reversalRefund
Customer changed mind (same day)Void
Defective product returnRefund

Inquiry Void

Check void status