---
title: "Cancel invoice"
method: PATCH
path: "/api/v1/services/invoices/{id}/cancel"
tags: ["invoices_service"]
---

# Cancel invoice

`PATCH /api/v1/services/invoices/{id}/cancel`

## Path parameters

- `id` string, required

## Query parameters

- `app_id` integer, required

## Response `200`

Service invoices fee

- InvoicesInvoice
  - `id` string, required
  - `amount` string, required
  - `overpayment` string
  - `description` string, required
  - `status` 'pending' | 'paid' | 'cancelled' | 'expired', required
  - `pay_to_address` string, required
  - `paid_by_address` string
  - `payment_link` string, required
  - `info` unknown
  - `date_change` integer, required
  - `date_expire` integer, required
  - `date_create` integer, required
  - `currency` 'TON' | 'USDT', required

## Other responses

- `400` — Something went wrong on client side
- `404` — The specified resource was not found
- `500` — Something went wrong on server side

## Changes

- **2024-11-06** `dc03bb6c514d` — 1 info
  - the `currency` response's property default value `TON` was removed for the status `200`
- **2024-10-14** `f4284b424943` — 1 info
  - added the required property `currency` to the response with the `200` status
- **2024-03-22** `dbd561304b3b` — 1 info
  - added the optional property `info` to the response with the `200` status
- **2023-10-31** `f9f50dcb6417` — 1 info
  - added the media type `application/json` for the response with the status `200`
- **2023-10-26** `2596aa00157e` — 1 breaking
  - removed the media type `application/json` for the response with the status `200`

[Full history](https://skmtc.dev/tonkeeper/apis/rest-api-to-ton-console/changes/api/v1/services/invoices/:id/cancel/patch.md)

---

[API](https://skmtc.dev/tonkeeper/apis/rest-api-to-ton-console.md) · [All operations](https://skmtc.dev/tonkeeper/apis/rest-api-to-ton-console/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tonkeeper/rest-api-to-ton-console/revisions/bffcc11719d3/schema)