> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rebellapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Void

> Void the remaining amount of an authorized payment.

`POST /v1/payments/void`

Voids a paid order before the payment is captured or the order confirmed, returning funds to the payer. Supports partial or full void operations.

## Request Parameters

<ParamField body="voidRequestId" type="string" required>
  Merchant-generated unique ID for this void request. Used for idempotence control.

  **Max length**: 64 characters
</ParamField>

<ParamField body="paymentId" type="string" required>
  Payment ID of the original authorization to be voided.

  **Max length**: 64 characters
</ParamField>

<ParamField body="voidAmount" type="object">
  Specific void payment amount. Defaults to full void if omitted. See [Amount](/openapis/v1/data-dictionary#amount).
</ParamField>

<ParamField body="extendInfo" type="string">
  Extension information.

  **Max length**: 4096 characters
</ParamField>

## Response Parameters

<ResponseField name="result" type="object" required>
  Standard result object with `resultCode`, `resultStatus`, `resultMessage`
</ResponseField>

<ResponseField name="voidRequestId" type="string">
  Merchant's void request ID.

  **Max length**: 64 characters
</ResponseField>

<ResponseField name="voidId" type="string">
  Wallet-generated unique void ID.

  **Max length**: 64 characters
</ResponseField>

## Result Codes

| resultStatus | resultCode                      | Description                                      |
| ------------ | ------------------------------- | ------------------------------------------------ |
| `S`          | `SUCCESS`                       | Void successful                                  |
| `F`          | `PARAM_ILLEGAL`                 | Missing or invalid required parameter            |
| `F`          | `ORDER_UNSUPPORTED_OPERATION`   | Order does not support void                      |
| `F`          | `VOID_AMOUNT_EXCEED`            | Void amount exceeds the original payment amount  |
| `F`          | `MUTEX_OPERATION_IN_PROCESSING` | Another void, confirm, or capture is in progress |
| `F`          | `PARTNER_BALANCE_NOT_ENOUGH`    | Insufficient partner balance                     |
| `U`          | `UNKNOWN_EXCEPTION`             | Unknown error occurred                           |