# Membatalkan tagihan

## Ikhtisar

Anda dapat membatalkan tagihan agar pembeli tidak bisa lagi membayarnya. Ini berguna saat ada kesalahan di dalam tagihan. Pembatalan memerlukan dua syarat:

* Status tagihan: Belum dibayar (Unpaid)
* Tampilan halaman pembayaran: 0

Jika tagihan milik proyek lain dan kunci dibatasi pada satu proyek, metode membalas dengan `Restricted project`. Jika Anda tidak punya tagihan dengan identifikasi itu—`Invoice not found`. Jika tagihan ditemukan tetapi syarat pembatalan tidak terpenuhi—`Invoice cannot be canceled`.

## Permintaan

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

## Parameter permintaan

| Parameter   | Tipe data | Deskripsi                    | Contoh                               | Wajib?    |
| ----------- | --------- | ---------------------------- | ------------------------------------ | --------- |
| `invoiceId` | UUID      | ID tagihan dalam format UUID | ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c | ya        |

## Contoh respons

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