removeBeneficiary需要签名验签

2024-08-15 07:42

POST /amsin/api/v1/business/account/removeBeneficiary

集成商可调用此接口删除已绑定的收款人，一次调用可删除一个收款人。

报文结构

万里汇接口报文结构包括：请求头、请求体。

由集成商定义、用于唯一标识某次收款人删除请求。

本字段（removeBeneficiaryRequestId）和 bindBeneficiaryRequestId 字段不可混淆。

更多信息：

用于OAuth校验的访问令牌。

更多信息：

为加密字符串，包含收款人银行账户相关信息。

加密内容使用 Base64 进行编码，具体详见编码标准部分。

更多信息：

代表API 接口的调用结果。

Show child parameters

为加密字符串，包含收款人银行账户相关信息。

加密内容使用 Base64 进行编码，具体详见编码标准部分。

API Explorer

URL

请求体

响应体

集成商调用接口后，万里汇返回集成商API调用结果。result.resultStatus 字段取值范围为：

结果码	值	结果码信息	行动建议
SUCCESS	S	Success
PROCESS_FAIL	F	A general business failure occurred. Do not retry.	需要人工介入，联系万里汇技术支持以解决此问题
PARAM_ILLEGAL	F	Illegal parameters exist. For example, a non-numeric input, or an invalid date.	参考API文档页面，确认请求头和传参是否正确
UNKNOWN_EXCEPTION	U	API failed due to unknown reason.	服务器错误，若稍后重试问题依旧，联系万里汇技术支持以解决问题
REQUEST_TRAFFIC_EXCEED_LIMIT	U	The request traffic exceeds the limit.	重试，若问题依旧，联系万里汇技术支持
OAUTH_FAIL	F	OAuth process failed.	联系万里汇技术支持了解详情
INVALID_API	F	The called API is invalid or not active.	确认是否调用正确的API
INVALID_CLIENT	F	The client is invalid.	Client ID不存在或无效，需确认信息正确
INVALID_SIGNATURE	F	The signature is invalid.	确认请求正确加签，具体参见：请求头签名部分生成签名
METHOD_NOT_SUPPORTED	F	The server does not implement the requested HTTP method.	确认HTTP请求方法为`POST`

结果码	值	结果码信息	行动建议
UN_SUPPORT_BUSINESS	F	Unsupported business.	包含无效参数（如货币代码错误），使用正确的参数重试
USER_NOT_EXIST	F	The user does not exist.	使用正确的用户信息重试
BENEFICIARY_NOT_EXIST	F	The beneficiary does not exist.	检查收款人信息后重试
REPEAT_REQ_INCONSISTENT	F	Repeated requests are inconsistent.	确认请求中所有参数一致

字段名	是否必传	范例	说明
Client-Id	是	`Client-Id: *****`	关于这些参数的解释说明，详见：请求头。
Signature	是	`Signature: algorithm=RSA256, keyVersion=2, signature=*****`
Content-Type	是	`Content-Type: application/json; charset=UTF-8`
Request-Time	是	`Request-Time: 2019-04-04T12:08:56+08:00`
Connected-CustomerId	否	`Connected-CustomerId: *****`	注意由万里汇定义、用于唯一标识某万里汇账户。注：该字段原为请求体中的customerId字段。两个字段在API实现逻辑上一致，对已完成集成的功能没有任何影响，您可以继续使用请求体中的customerId字段，或使用Connected-CustomerId重新集成。

Result status	描述
S	接口调用成功
F	接口调用失败，具体原因参见`result.resultCode`
U	调用结果未知，需重试API请求。重试策略：重试次数上限：7次重试时间间隔：5分钟、10分钟、20分钟、40分钟、80分钟、160分钟、320分钟若上述重试均未成功，联系万里汇技术支持。