更新付款方
概述
更新付款方接口用于修改已存在的付款方信息。当付款方的地址、联系人、邮箱或证件有效期发生变更时，您可以通过该接口更新相关信息。
重要说明
更新操作不会改变 payerId，仅修改付款方的相关信息。
适用场景
| 场景 | 描述 | 示例 |
|---|---|---|
| 信息有误 | 创建时信息填写错误需要更正 | 地址、电话、邮箱错误 |
| 证件更新 | 证件到期需要重新上传 | 营业执照、身份证到期 |
| 地址变更 | 子商户的注册地址发生变化 | 办公室搬迁、注册地变更 |
| 联系人变更 | 联系人或联系方式更新 | 负责人更换、电话变更 |
| 定期维护 | 定期更新信息以保持准确 | 年度信息核查 |
操作流程
步骤 1：查询当前信息
- 调用查询接口 付款人查询接口
- 获取当前付款方完整信息
为什么要先查询？
先查询可以确保您了解当前的完整信息，避免覆盖不需要修改的字段。
步骤 2：准备更新数据
确定需要修改的字段 付款人更新接口：
- 地址信息
- 联系人信息
- 联系邮箱
- 联系电话
- 证件信息
步骤 3：提交更新请求
- 调用更新接口 付款人更新接口
- 传入 payerId + 更新字段
步骤 4：系统验证
系统验证更新内容：
- 数据格式验证
- 必填字段检查
- 合规性验证
更新 vs 重新创建
| 对比项 | 更新付款方 | 重新创建付款方 |
|---|---|---|
| payerId | 保持不变 | 会生成新 ID |
| 历史记录 | 保留 | 丢失 |
| 关联交易 | 保持关联 | 需重新关联 |
| 审核时长 | 通常较快 | 需完整审核 |
| 适用场景 | 信息变更 | 完全新的法律实体 |
建议
除非是完全不同的法律实体，否则优先使用更新接口而非删除后重建。
常见问题
Q1：更新后多久可以用于付款？
解答
- 立即生效
Q2：可以只更新部分字段吗？
解答
可以。您只需要传入需要更新的字段，其他字段保持不变。
Q3：更新失败了怎么办？
解答
检查以下几点：
- 必填字段是否完整
- 数据格式是否正确
- 新上传的证件是否清晰有效
- 签名是否正确
- payerId 是否存在
Q4：更新操作会影响正在进行的付款吗？
解答
- 不会影响正在处理的付款
Q6：可以撤销更新吗？
解答
不能自动撤销。如需恢复原信息，需要再次调用更新接口，传入原来的数据。
建议：更新前保存原始信息，以便必要时恢复。