跳到主要内容

取消收款单

概述

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

  • 收款单状态:待支付 (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"

请求参数

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

响应示例

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