# 取消收款单

## 概述

可以取消收款单，让买家无法再支付它。收款单有误时很有用。取消需要满足两个条件：

* 收款单状态：待支付 (Unpaid)
* 支付页面浏览次数：0

如果收款单属于其他项目且密钥限定到项目，方法返回 `Restricted project`。没有该标识的收款单时——`Invoice not found`。收款单找到了但不满足取消条件时——`Invoice cannot be canceled`。

## 请求

```bash
curl -X POST https://api.bitsby.app/invoices/cancel \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "invoiceId=ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c"
```

## 请求参数

| 参数        | 数据类型 | 说明                 | 示例                                 | 是否必填 |
| ----------- | -------- | -------------------- | ------------------------------------ | -------- |
| `invoiceId` | UUID     | 收款单 ID，UUID 格式 | ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c | 是       |

## 响应示例

```json
{
   "result":"success",
   "data":"Invoice canceled"
}
```