Z Zise Developers
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
}
404not_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()