取消收款单
概述
可以取消收款单,让买家无法再支付它。收款单有误时很有用。取消需要满足两个条件:
- 收款单状态:待支付 (Unpaid)
- 支付页面浏览次数:0
如果收款单属于其他项目且密钥限定到项目,方法返回 Restricted project。没有该标识的收款单时——Invoice not found。收款单找到了但不满足取消条件时——Invoice cannot be canceled。
请求
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 | 是 |
响应示例
{
"result":"success",
"data":"Invoice canceled"
}