# इनवॉइस रद्द करें

## अवलोकन

आप इनवॉइस रद्द कर सकते हैं, ताकि ग्राहक उसका भुगतान न कर सके। यह तब काम आता है, जब इनवॉइस में ग़लती हो। रद्द करने के लिए दो शर्तें ज़रूरी हैं:

* इनवॉइस की स्थिति: भुगतान बाकी
* भुगतान पृष्ठ के व्यू: 0

अगर इनवॉइस दूसरे प्रोजेक्ट का है और कुंजी प्रोजेक्ट तक सीमित है, तो मेथड `Restricted project` लौटाता है। अगर उस ID का कोई इनवॉइस आपके पास नहीं है — `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      | UUID फ़ॉर्मैट में इनवॉइस ID | ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c | हाँ       |

## जवाब का उदाहरण

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