---
updatedAt: 2025-09-24T00:51:58.000Z
agentTools:
  projectIndex: https://docs.skipify.com/llms.txt
---

# Reverse Order

Learn how to reverse a previously submitted transaction

<HTMLBlock>{`
<style>
.App {
  --font-family: 'poppins', 'helvetica';
}
</style>
`}</HTMLBlock>

# Overview

Use this endpoint if you are unsure of the status of an order and want to void it or issue a refund. Authorization transactions will be reversed to cancel/void, and capture will  be reversed to refund.

> ❗️ Important
>
> A reversal can only be done in full. Partial amounts are not supported.

> 👍 This endpoint uses API Key Authentication
>
> Check out our [API Key Authentication Section](https://docs.skipify.com/docs/api-authentication-api-key) section to learn more

To Reverse an order, send an API call to:

> **Staging**: `POST https://orders-management.staging.skipify.com/{orderId}/reverse`
>
> **Production**: `POST https://orders-management.skipify.com/{orderId}/reverse`

# Request Body Parameters

<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th>
        Parameter Name
      </th>

      <th>
        Required
      </th>

      <th>
        Type
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        transactionId
      </td>

      <td>
        no
      </td>

      <td>
        string
      </td>

      <td>
        Pass the transactionId received from the ORDER\_PAYMENT\_SUCCEEDED webhook event.\
        This can be passed in all cases. It is required in a [split-payment](https://docs.skipify.com/docs/skipify-features#split-payments) scenario, when multiple transactions are tied to one orderId.
      </td>
    </tr>
  </tbody>
</Table>

## Request Body Example

```json
{
  "transactionId": "string"
}
```

# API Response

## Response Body Parameters

| Parameter Name   | Type                | Description                                                                |
| :--------------- | :------------------ | :------------------------------------------------------------------------- |
| orderId          | string              | The Skipify order id                                                       |
| merchantId       | string              | The Skipify Merchant Identifier                                            |
| transactionId    | string              | The Skipify transaction identifier                                         |
| status           | string              | Allowed Values = Reversed, Failed                                          |
| pspTransactionId | string              | The TransactionId from the PSP for this event                              |
| message          | string, conditional | This message will be populated if there was an error processing the refund |

## Response Body Example

```json JSON Response Body
{
  "orderId": "string",
  "merchantId": "string",
  "transactionId": "string",
  "status": "Reversed",
  "pspTransactionId": "string",
  "message": "string"
}
```

***

<HTMLBlock>{`
<a href="https://www.skipify.com/get-in-touch"><img src="https://files.readme.io/279452f-CTA_Contact_Footer_1440x205_Final.png" alt="Skipify baner with link to contact us form"></a>
`}</HTMLBlock>