创建付款方
概述
创建付款方接口允许机构在 Payout 业务中，自定义付款方信息代表其下属企业或个人发起付款。机构作为接入方与 Onerway 对接，但在整个付款交易中，机构身份不对外展现，对外展现的是机构自定义的付款方。
什么是付款方？
付款方（Payer）是机构自定义的、对外展现的付款主体：
- 机构：与 Onerway 对接的接入方，负责发起付款请求，但对外不可见
- 付款方：机构自定义的付款主体信息，代表其下属企业或个人，是实际对外展现的付款来源
- 关联关系：后端自动维护机构与付款方的关联关系，确保权限隔离和数据安全
- 灵活自定义：机构可根据实际业务需要，灵活自定义付款方信息
适用场景
| 场景 | 描述 | 示例 |
|---|---|---|
| 金融机构代付 | 银行或支付机构代表其企业客户发起付款 | 银行为企业客户发起工资代发、供应商付款 |
| 财务外包服务 | 财务服务商代表客户企业处理付款 | 财务代理公司为多家企业处理应付账款 |
| 薪资代发平台 | 人力资源服务商代表企业向员工发放薪资 | HR SaaS 平台为入驻企业发放工资 |
| 供应链金融 | 核心企业代表上下游企业进行资金结算 | 供应链平台为供应商、经销商结算 |
| 跨境电商平台 | 平台代表卖家向供应商或服务商付款 | 跨境电商代表商家支付物流费用 |
为什么需要自定义付款方？
传统直付模式：
- 企业自行对接支付通道
- 企业直接向收款方付款
机构 Payout 模式：
- 机构统一对接 Onerway
- 机构自定义付款方（代表下属企业 A）→ 以企业 A 名义向收款方付款
- 机构自定义付款方（代表下属企业 B）→ 以企业 B 名义向收款方付款
- 机构自定义付款方（代表个人 C）→ 以个人 C 名义向收款方付款
- 整个付款交易中，机构身份完全不对外展现
自定义付款方的优势
- 降低接入成本 - 下属企业/个人无需单独对接，由机构统一管理
- 真实付款主体 - 对外展现机构所代表的真实企业或个人，符合业务实质
- 自动关联管理 - 后端自动维护机构与付款方的关联关系，确保权限隔离和数据安全
- 灵活自定义 - 机构可根据实际业务需要，灵活自定义付款方信息
- 合规透明 - 付款记录、对账单等均显示自定义的付款方，满足监管要求
操作流程
步骤 1：准备付款方信息
机构根据业务需要，自定义其所代表的下属企业或个人的付款方信息付款人添加接口：
企业付款方关键信息：
基础信息
- companyName / companyNameEn（公司名称/公司英文名称，企业必填）
- subEntityType（类型："0"公司）
注册与地址信息
- country（国家）
- addressEn1、addressEn2、addressEn3（注册地址）
- registerNo（注册号，企业必填）
- registerDate（注册时间，企业必填）
- postcode（邮编）
- state（省）、city（市）
联系人与通信方式
- email（邮箱）
- areaCode（区号）
- phoneNumber（手机号）
证件及合规信息
- idType（证件类型）
- idNumber（证件号码）
- idValidDateFrom（证件有效期开始）
- idValidDateTo（证件有效期截止）
- sign（签名）
个人付款方关键信息：
基础信息
- firstName / lastName（姓 / 名，个人必填）
- subEntityType（类型："1"个人）
地址与出生信息
- country（国家）
- addressEn1、addressEn2、addressEn3（地址）
- postcode（邮编）
- state（省）、city（市）
- birthDate（出生日期）
联系方式
- email（邮箱）
- areaCode（区号）
- phoneNumber（手机号）
证件及合规信息
- idType（证件类型）
- idNumber（证件号码）
- idValidDateFrom（证件有效期开始）
- idValidDateTo（证件有效期截止）
- sign（签名）
重要说明
- 付款方信息由机构自定义并提供，代表其下属企业/个人
- 机构需确保自定义信息的准确性和合规性
- 系统会验证信息的合理性和合规性
- 后端会自动维护机构与自定义付款方的关联关系，机构在整个付款交易中对外不可见
步骤 2：提交创建请求
- 机构调用创建接口 付款人添加接口
- 提交自定义的付款方详细信息（代表其下属企业或个人）
- 后端自动建立并维护机构与该付款方的关联关系
步骤 3：获取 payerId
- 验证通过
- 返回唯一的 payerId
- 付款方创建成功
步骤 4：使用付款方
- 机构保存返回的 payerId
- 机构在发起付款时，指定该 payerId 通过收款方ID发起付款接口或者实时收款方信息付款接口
- 整个付款交易中，对外展现的是该自定义的付款方身份
- 收款方看到的付款来源是该自定义的付款方，机构身份完全不对外展现
付款方 vs 收款方
| 对比项 | 付款方 | 收款方 |
|---|---|---|
| 角色 | 资金发送方（对外展现） | 资金接收方 |
| 谁创建 | 机构自定义创建 | 机构/下属企业创建 |
| 数量 | 根据下属企业/个人数量 | 可以有很多个 |
| 用途 | 标识付款主体（代表下属企业/个人） | 标识收款账户 |
| 是否必须 | 机构 Payout 模式必须 | 总是必须 |
| 对外展现 | 对外展现，机构不展现 | 对外展现 |
常见问题
Q1：一个机构可以创建多少个付款方？
解答
通常没有硬性限制，建议根据实际下属企业/个人数量创建。机构可以为每个下属企业或个人自定义一个付款方，后端自动维护关联关系。
Q2：创建付款方需要多长时间？
解答
系统会自动审核，通常在几分钟内完成
Q3：审核被拒绝了怎么办？
解答
- 查看拒绝原因
- 根据反馈修改信息
- 重新提交创建请求
- 如有疑问，联系客户经理
Q4：付款方和机构账户有什么区别？
解答
- 机构账户 - 与 Onerway 对接的主体，在整个付款交易中对外不展现
- 付款方 - 机构自定义的付款主体，代表下属企业/个人，是对外展现的实体
简单理解：机构是"幕后管理者"，付款方是"台前展现者"。后端自动维护两者的关联关系。
Q5：可以修改自定义付款方的名称吗？
解答
谨慎修改。自定义的付款方名称通常对应下属企业/个人的真实身份，如有需要，可使用付款人更新接口