更新收款方
概述
更新收款方用于修改已存在的收款人信息。当收款方的地址变更、账户更换或证件到期时，您可以通过该接口更新相关信息。
重要说明
更新操作不会改变 beneficiaryId，仅更新收款方的具体数据信息。
适用场景
| 场景 | 描述 | 示例 |
|---|---|---|
| 银行信息变更 | 收款人更换了银行账户 | 账号变更、银行更换 |
| 地址更新 | 收款人搬家或地址信息有误 | 邮寄地址、联系地址 |
| 证件更新 | 证件到期需要更新 | 身份证、护照有效期 |
| 审核反馈修正 | 根据审核反馈修改信息 | 补充缺失字段、修正错误 |
| 定期维护 | 定期更新证件或证明以保持有效 | 合规性维护 |
操作流程
步骤 1：查询当前收款方信息
- 调用查询接口收款方详情查询接口
- 获取当前收款方完整信息
- 确认需要修改的字段
为什么要先查询？
先查询可以确保您了解当前的完整信息，避免覆盖不需要修改的字段。
步骤 2：修改必要字段
准备更新数据：
- 基础信息（姓名、国家）
- 账户信息（银行账号、银行代码）
步骤 3：提交更新请求
- 调用更新接口 更新收款方接口
- 传入 beneficiaryId + 更新字段
- 系统验证数据合法性
- 验证通过，更新成功
更新 vs 重新创建
| 对比项 | 更新收款方 | 重新创建收款方 |
|---|---|---|
| beneficiaryId | 保持不变 | 会生成新 ID |
| 历史记录 | 保留 | 丢失 |
| 关联交易 | 保持关联 | 需重新关联 |
| 适用场景 | 信息变更 | 完全新的收款方 |
| 推荐指数 | 五星推荐 | 三星 |
建议
除非是完全不同的收款方，否则优先使用更新接口而非删除后重建。
常见问题
Q1：更新银行账户后，什么时候可以用于付款?
解答
更新成功后立即生效，可以马上用于付款。
Q2：可以只更新部分字段吗？
解答
可以。您只需要传入需要更新的字段，其他字段保持不变。
Q3：更新失败了怎么办？
解答
检查以下几点：
- 必填字段是否完整
- 数据格式是否正确
- 新数据是否符合该国家/币种的要求
- 签名是否正确
Q4：更新操作会影响正在进行的付款吗？
解答
不会。正在处理的付款使用的是更新前的信息，不受影响。
Q5：可以撤销更新吗？
解答
不能自动撤销。如需恢复，需要再次调用更新接口，传入原来的信息。