直接使用收款方信息进行付款

概述

实时付款 - 在单次请求中创建收款方并完成付款，无需预先创建 payeeId。收款方的身份、地址、账户信息可直接在请求体中传递，适用于高频或动态付款场景。

权限要求

当前为受限访问接口，需联系技术支持开通权限后方可使用。

核心原理

该接口免除了预创建 payeeId 的步骤，所有收款方信息在付款请求中实时提交并验证。

优势

优势	说明
实时性强	一次请求完成收款方创建与付款
动态灵活	可在请求中内嵌收款方信息（payeeDetail）
流程简化	适用于实时性、动态付款场景
适合一次性付款	无需管理大量收款方 ID

对比：预创建 vs 实时付款

对比项	预创建收款方模式	实时付款模式
流程	创建收款方 → 获取 payeeId → 发起付款	直接发起付款（同时提供收款方信息）
API 调用	2 次（创建 + 付款）	1 次
适用场景	高频付款、固定收款方	一次性付款、动态收款方
管理复杂度	需管理收款方 ID	无需管理
权限要求	标准权限	需申请特殊权限

1 使用前准备

步骤 1：环境要求

环境要求

所有集成必须首先在 Sandbox 环境中进行测试。确保功能正确后再切换至 Production 环境。

环境	用途
Sandbox 环境	用于集成测试和调试
Production 环境	用于正式交易

提示

详细信息请参考 接入说明

步骤 2：接入签名

安全要求

在调用任何 API 之前，您必须生成一个签名（sign）并使用您的私钥（privateKey）来确保请求安全。

完整的签名说明请参见：

INFO

参考文档 接入签名

步骤 3：确认付款方式

在发起付款前，您应该根据业务需求选择合适的付款方式：

• LOCAL（本地转账）
• SWIFT（国际电汇）
• 数字钱包

可用的付款方式取决于目标国家、币种等因素。

INFO

参考文档 付款方式查询接口

步骤 4：确认收款方必填字段

根据以下参数获取必填字段信息：

• 国家
• 币种
• 主体类型（个人/企业）
• 付款方式

系统会根据这些参数返回完整的必填字段列表，确保付款方信息完整合规。

INFO

参考文档 收款方必填字段查询接口

步骤 5：以他人身份代付（可选）

如果您需要代表个人或实体（例如平台代创作者付款），您需先添加付款方信息。

代付场景：

• 平台以子商户名义向收款方付款

INFO

参考文档 付款人添加接口

2 实时付款执行

接口信息

API 接口

接口地址： 实时收款方信息付款接口

请求参数说明

无需预先注册收款方，请求中可以：

• payeeDetail 包含完整的收款方信息（姓名、账户、地址等）
• 实时发起付款

常见问题

Q1：实时付款和预创建收款方，哪个更好？

解答

取决于使用场景：

• 高频付款、固定收款方 → 推荐预创建模式
• 一次性付款、动态收款方 → 推荐实时付款模式

Q2：实时付款的处理速度和预创建模式一样吗？

解答

一样快。实时付款只是省去了预创建收款方的步骤，实际付款处理速度相同。

Q3：实时付款失败了怎么办？

解答

失败原因可能包括：

• 收款方信息填写错误
• 必填字段缺失
• 账户余额不足
• 银行账户无效

根据错误提示修正后重新提交即可。

Q4：实时付款会生成收款方 ID 吗？

解答

不会。

Q5：如何申请实时付款权限？

解答

请联系您的客户经理或技术支持团队，说明您的业务场景和需求，申请开通实时付款功能。