跳到正文

API

本页内容

模拟支付

让沙箱账单走完一个付款结果,测试与真实链上转账确认相同的生命周期和 webhook。

POST/v1/sandbox/invoices/:invoice_id/simulate-payment

API 密钥: Payment · 环境: 仅沙箱

在不移动真实资金的情况下模拟一笔已确认的付款。账单必须属于已认证商户且处于沙箱环境。生产 key 会被拒绝。

请求体

stage 必填,且只能取以下之一:

  • paid——支付应付金额;
  • overpaid——支付比应付金额多 10%;
  • underpay——只支付应付金额的 40%;账单领域规则决定它保持打开还是进入终态;
  • cancel——取消仍可取消的账单。
{
  "stage": "paid"
}

所有模拟金额都由服务器从账单推导。客户端从不自行计算结算金额。

响应 (200 OK)

返回更新后的账单资源,并发出与对应真实结果相同的生命周期 webhook 事件。响应字段见 获取账单