接入指南

概览

跨境资金划转与打款服务。

在调用 Transfer API 之前，请先完成沙盒开户、白名单配置和商户凭证准备。建议先把环境和商户信息准备好，再进入签名和集成流程。

概述

沙盒环境和生产环境的差异主要在请求域名。建议先在沙盒环境完成联调，再切换到生产环境。

环境准备主要包括以下事项：

生产环境和沙盒环境的请求地址仅域名不同。也就是说，接入流程通常是：

这样可以先在测试环境暴露问题，避免把环境和业务问题叠加到生产切换阶段。

环境	域名
沙盒环境	`https://sandbox-api.onerway.com/payout`
生产环境	`https://api.onerway.com/payout`

创建沙盒测试商户前，请先准备：

开户邮箱会用于创建沙盒账户。提交的域名会被加入白名单，只有白名单中的域名才能调用 Onerway API。

这意味着在环境准备阶段，除了“有没有账号”，还要确认：

如果域名未完成白名单配置，即使请求报文本身正确，也可能无法正常调用接口。

收到开通邮件后，请通过邮件中的商户后台链接登录。首次登录需要先重置密码，随后获取商户凭证。

在 Transfer 中，请使用实际请求字段名 merchantNo。

您通常需要准备：

Transfer 文档统一使用 merchantNo，不要替换成 merchantId。

字段表使用以下标识：

在开始构造请求报文、创建收款方或发起打款前，请确认：

完成这里的准备后，后续通常继续进入：

请求签名

了解 Transfer API 的两种签名方式以及对应示例。