Payout API 概览
产品介绍
Payout API 提供跨境及本地的付款能力，帮助企业或平台高效完成全球资金分发。通过统一的接口，您可以在不同国家和地区进行安全、合规的资金出款操作。
业务场景
向个人账户付款（Pay to Individual）
描述：将资金直接打至指定的自然人账户，用于工资发放、退款、补偿等场景。
向企业账户付款（Pay to Business）
描述：将资金打至法人或机构账户，用于供应商结算、服务费支付等企业间支付场景。
以他人身份代付（Payout on Behalf Of）
描述：以指定的个人或实体（个人、企业、创作者等）的身份发起付款（即平台或代理商出款）。常用于平台代表创作者发放收益、第三方代理机构代客户完成对外支付等场景。
环境说明
生产环境（Production）和沙盒环境（Sandbox）仅在域名上有所不同。
建议
建议您先在沙盒环境中测试 Payout API，确认业务流程正确后再切换至生产环境。
| 环境类型 | 基础域名 | 用途说明 |
|---|---|---|
| Sandbox（测试环境） | https://api-sandbox.example.com | 模拟出款流程，不会实际扣款 |
| Production（正式环境） | https://api.example.com | 正式交易与生产环境 |
接入步骤
步骤 1：提供开户信息
- 提供用于创建沙盒账户的邮箱
- 提供对接测试环境的域名
- 域名将被添加到白名单
注意
仅白名单内的域名可调用 Onerway API，请确保您的域名已添加。
步骤 2：登录商户客户端
- 接收邮件中的登录链接
- 首次登录后重置密码
- 完成密码设置后即可正常使用
步骤 3：获取商户信息
登录后可获取以下重要信息：
| 信息项 | 说明 | 用途 |
|---|---|---|
| 商户号 | Merchant ID | 用于标识商户身份 |
| 私钥 | Private Key | 用于 API 请求签名 |
安全提示
这些信息将用于后续 API 接口调用与请求签名，请妥善保管，不要泄露。
步骤 4：开始测试
- 在沙盒环境充分测试
- 验证业务流程正确性
- 切换到生产环境
- 正式上线运营
上线前检查清单
- 所有业务流程测试通过
- 签名机制验证正确
- 回调地址配置无误
- 错误处理逻辑完善
重要提示
请注意
- 沙盒环境用于测试和调试，不会产生真实交易
- 切换至生产环境前，请务必确认所有参数、签名与回调地址已正确配置
- 所有 API 请求都需携带有效的商户 ID 与签名信息进行身份验证
- 请妥善保管您的私钥，避免泄露造成安全风险