查询付款方
概述
查询付款方接口用于获取主商户名下所有已创建的付款方信息。该接口返回商户下全量付款方列表及其对应的 payerId，用于查看和管理所有付款方实体。
使用场景
通过此接口可以获取商户下所有付款方的基本信息和状态，便于选择合适的付款方发起付款操作。
适用场景
| 场景 | 描述 |
|---|---|
| 获取可用付款方 | 获取商户下所有付款方列表，选择可用的 payerId 发起付款 |
| 付款方管理 | 查看商户下所有付款方的注册资料、审核进度和状态 |
| 状态监控 | 批量检查所有付款方的审核状态和信息变更 |
| 数据同步 | 将付款方列表同步到业务系统中进行管理 |
操作流程
步骤 1：调用查询接口
调用查询接口 付款人查询接口 获取付款方列表
步骤 2：获取列表信息
系统返回商户下所有付款方信息，包括：
- 付款方 ID (
payerId) - 公司名称
- 注册国家
- 地址信息
- 联系方式
- 证件信息
- 当前状态
步骤 3：定位自己想要的付款方
根据状态、付款方信息筛选自己想要的付款方
常见问题
Q1：查询接口有调用频率限制吗？
解答
通常有频率限制，建议：
- 列表查询 - 不超过 100 次/分钟
- 建议使用缓存 - 减少重复查询，可缓存 1-24 小时
Q2：如果商户下没有付款方会返回什么？
解答
会返回空列表
Q3：付款方信息更新后，多久能查到最新信息？
解答
立即生效。更新接口调用成功后，查询接口可立即获取最新信息。
Q4：返回的列表有数量限制吗？
解答
返回商户下的全量付款方列表，无数量限制。如果付款方数量非常多（如超过100个），建议：根据业务需要进行筛选和分页展示
Q5：如何快速找到可用的付款方？
解答
从返回列表中筛选账号状态与付款方信息即可。