DELETE
/v1/remit/payees/{id}
解除关联(删的是关联不是主体)
Scope
remittances:write
代会员调用 · 必带 x-on-behalf-of
删的是「这个会员 ↔ 这个收款人」的关联,不是收款人主体。
主体是平台级共享的 —— 别的会员可能正汇向同一个银行账户,
删主体等于替别人做决定。
所以:删完再用同样的字段建一次,多半拿回的是 outcome: linked
和同一个 id(指纹没变),而不是一个新收款人。这是对的。
已经下过的订单不受影响:订单行上存的是收款人快照。
⚠ 这个端点不要幂等键(它天然幂等:删第二次是 404)。
但它仍是写操作,签名规则照旧。
路径参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id |
string | 必填 | 收款人号。pye_ 前缀可带可不带;剥掉后必须是纯数字。 |
请求头
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
x-on-behalf-of |
string | 必填 | 代哪个会员调用。 |
响应
200已解除关联
{
"deleted": true
}404
not_found 这个会员名下没有这条关联(或已经解除过了)。
id 不是数字也走这一档 —— 不区分是刻意的。
调用样例
curl -X DELETE 'https://api.zise.com/v1/remit/payees/{id}' \
-H 'authorization: Bearer $TOKEN' \
-H 'x-zise-merchant: $MERCHANT_ID' \
-H 'x-on-behalf-of: $MEMBER_ID'
const res = await fetch(
"https://api.zise.com/v1/remit/payees/{id}",
{
method: "DELETE",
headers: {
"authorization": "Bearer $TOKEN",
"x-zise-merchant": "MERCHANT_ID",
"x-on-behalf-of": "MEMBER_ID"
},
},
);
// 金额一律按字符串读,不要 JSON.parse 成 number
const data = await res.json();
import requests
res = requests.delete(
"https://api.zise.com/v1/remit/payees/{id}",
headers={
"authorization": "Bearer $TOKEN",
"x-zise-merchant": "$MERCHANT_ID",
"x-on-behalf-of": "$MEMBER_ID"
},
)
# 金额用 Decimal(str(...)),不要 float
data = res.json()