# Hủy hóa đơn

## Tổng quan

Bạn có thể hủy hóa đơn để người mua không còn thanh toán được nữa. Điều này hữu ích khi hóa đơn chứa sai sót. Việc hủy đòi hỏi hai điều kiện:

* Trạng thái hóa đơn: Chưa thanh toán (Unpaid)
* Lượt xem trang thanh toán: 0

Nếu hóa đơn thuộc dự án khác và khóa bị giới hạn theo dự án, phương thức trả về `Restricted project`. Nếu bạn không có hóa đơn với định danh đó — `Invoice not found`. Nếu tìm thấy hóa đơn nhưng điều kiện hủy không thỏa — `Invoice cannot be canceled`.

## Yêu cầu

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

## Tham số yêu cầu

| Tham số   | Kiểu dữ liệu | Mô tả               | Ví dụ                              | Bắt buộc? |
| ----------- | --------- | ------------------------- | ------------------------------------ | --------- |
| `invoiceId` | UUID      | ID hóa đơn ở định dạng UUID | ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c | có       |

## Ví dụ phản hồi

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