删除收款人

当某个收款人不再需要或其底层账户信息发生变更时，可将其删除。您可以通过创建收款人时返回的 userPaymentId（或从 GET /v2/payments 获取）来标识该记录。已删除的记录无法恢复——如需再次使用同一账户，请将其作为新的收款人添加。

端点

DELETE https://api.velafi.com/v2/payments/{userPaymentId}

沙盒环境测试请使用 https://api-test.velafi.com/v2/payments/{userPaymentId}。

integer

必填

要删除的收款人的唯一数字 ID。可从 GET /v2/payments 响应中的 id 字段获取。

integer

响应状态码。200 表示成功。

string

人类可读的响应消息。

boolean

如果收款人已成功删除，则为 true。

curl -X DELETE "https://api.velafi.com/v2/payments/228" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": true
}

删除前，请确认该 userPaymentId 当前未被任何进行中或待处理的订单引用。删除正在使用的收款人可能会导致订单处理出现问题。

⌘I