---
title: "Cancel order"
method: POST
path: "/asyncOrders/{referenceOrderID}/cancel"
tags: ["7. Async Orders"]
---

# Cancel order

`POST /asyncOrders/{referenceOrderID}/cancel`

## Request

- Base URL: `https://integration-api.tangocard.com/raas/v2`
- URL: `https://integration-api.tangocard.com/raas/v2/asyncOrders/{referenceOrderID}/cancel`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Cancel all eligible lineItems in an order, refund the amount, update the status, and update cancel eligibility for the line items.

## Path parameters

- `referenceOrderID` string, required

## Request body

- CancelOrderRequestCriteria
  - `reasonCode` 'ACCIDENTAL' | 'DUPLICATE' | 'FRAUD' | 'OTHER', required
  - `otherReason` string

## Response `202`

Accepted

- AsyncOrderActionView
  - `referenceOrderId` string
  - `externalRefID` string
  - `status` string
  - `totalLineItems` integer
  - `date` string, date-time

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `422`: Unprocessable Entity

## Changes

- **2026-11-03** `04d5b0da2197`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tangocard/apis/tango-api/changes/asyncOrders/:referenceOrderID/cancel/post.md)

---

[API](https://skmtc.dev/tangocard/apis/tango-api.md) - [All operations](https://skmtc.dev/tangocard/apis/tango-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tangocard/apis/tango-api/revisions/04d5b0da2197?raw)