---
title: "Void order"
method: POST
path: "/v2/payments/{token}/void"
tags: ["Orders"]
---

# Void order

`POST /v2/payments/{token}/void`

Void any authorizations for the order. The customer is informed of the cancellation and that the order could not be fulfilled; any held funds are released.

## Path parameters

- `token` string, string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `merchantReference` string — Merchant reference for tracking the order in your system.

## Response `200`

Order voided successfully

- object
  - `token` string, required — The order token.
  - `merchantReference` string — The merchant reference.
  - `voidedAt` string — The date and time when the order was voided.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `409` — Conflict

---

[API](https://skmtc.net/scalapay/apis/scalapay-api.md) · [All operations](https://skmtc.net/scalapay/apis/scalapay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalapay/scalapay-api/versions/c43238b80cb9/schema)