removeBeneficiary

2026-02-27 16:39

POST /v1/aba/accounts/removeBeneficiary

调用此接口删除收款人，每次调用仅限移除一位收款人。

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息，有关报文头的结构信息，请参阅：

注意：将每个字段（除数组外）的数据类型设置为字符串。这意味字段值必须使用双引号（" "）括起来。例如：

包含收款人银行账户详情的加密信息，采用 Base64 算法进行编码。

更多信息：

商户为识别收款人删除请求而分配的专属 ID。

更多信息：

表明此接口是否调用成功。

Show child parameters

API Explorer

URL

Method

POST

请求体

响应体

结果码	值	结果码信息	行动建议
SUCCESS	S	成功。	接口调用成功，无需进一步操作。
PROCESS_FAIL	F	发生了一般业务失败。	通常需要人工干预。建议联系 Antom 技术支持团队解决问题。
PARAM_ILLEGAL	F	存在非法参数，例如非数字输入或无效日期。	检查并验证请求字段（包括头部字段和正文字段）是否正确且有效。
UNKNOWN_EXCEPTION	U	由于未知原因，接口调用失败。	服务可能不可用，请稍后重试。如果问题仍然存在，请联系 Antom 技术支持。
REQUEST_TRAFFIC_EXCEED_LIMIT	U	请求流量超出限制。	再次调用接口以解决问题。如果问题仍然存在，请联系 Antom 技术支持团队。
OAUTH_FAIL	F	OAuth 流程失败。	请联系 Antom 技术支持团队获取详细原因。
INVALID_API	F	调用的接口无效或未激活。	检查是否调用了正确的接口。
INVALID_CLIENT	F	客户端无效。	客户端 ID 不存在或无效。
INVALID_SIGNATURE	F	签名无效。	确保请求已使用有效签名正确签署。
METHOD_NOT_SUPPORTED	F	服务器不支持所请求的 HTTP 方法。	确保 HTTP 方法是 POST。
UN_SUPPORT_BUSINESS	F	不支持的业务。	使用的参数无效，例如货币不正确。请使用正确的信息重试。
USER_NOT_EXIST	F	用户不存在。	使用正确的用户信息重试。
BENEFICIARY_NOT_EXIST	F	收款人不存在。	检查收款人信息并重试。
REPEAT_REQ_INCONSISTENT	F	重复请求不一致。	确保所有请求字段相同。