本页内容
模拟支付
让沙箱账单走完一个付款结果,测试与真实链上转账确认相同的生命周期和 webhook。
POST/v1/sandbox/invoices/:invoice_id/simulate-payment
API 密钥: Payment · 环境: 仅沙箱
在不移动真实资金的情况下模拟一笔已确认的付款。账单必须属于已认证商户且处于沙箱环境。生产 key 会被拒绝。
请求体
stage 必填,且只能取以下之一:
paid——支付应付金额;overpaid——支付比应付金额多 10%;underpay——只支付应付金额的 40%;账单领域规则决定它保持打开还是进入终态;cancel——取消仍可取消的账单。
{
"stage": "paid"
}
所有模拟金额都由服务器从账单推导。客户端从不自行计算结算金额。
响应 (200 OK)
返回更新后的账单资源,并发出与对应真实结果相同的生命周期 webhook 事件。响应字段见 获取账单。