对接指引

一、获取调用 API 访问凭证

提供注册邮箱会收到初始登录密码

根据邮件登录商户系统提交 KYC 信息

KYC 通过, 进入商户系统开发者选项获取 Client ID, Client Secret

二、 API 地址

环境	地址
测试	https://demo-api.easypayx.com
生产	https://api.easypayx.com

三、附录说明

5. 异步回调

先创建 Webhook 订阅需要监听的类型 types 支持 * 表示监听所有业务通知

回调参数说明参考API中的通知

通知频率

如果商户未按正常处理做出应答（http 状态码 200）将认为该次通知是失败的，间隔一定时间后会尝试再次通知, 请商户做好幂等处理。

通知频率间隔 15s,15s, 30s, 3min ,10min, 20min, 30min, 30min, 30min, 1h, 3h, 3h, 3h, 6h, 6h

四、API 调用流程

创建账户

申请收款账户

说明

如果收到收款账户失败通知，失败原因如果是由于客户本身有问题（渠道风控等原因没有通过）收款账户申请失败，不需要再重新调用申请收款账户接口。

入账

转账 account 之间内部转账

换汇

付款（结算到银行账户）

五、常见问题

图片/文件上传

1、API 中涉及到的图片/文件上传到哪里？

上传到 EasyPay 的 OSS 上，测试和生产配置会通过邮件发送

上传后的路径填写格式

实名认证

1、创建账户中的企业英文名字段 company_name_en 作用？

company_name_en 字段用来作为开 VA 账户的名字，可以不与企业名称完全一致，VA 账户名仅支持 a-z, A-Z, 0-9 / - ? : ( ) . , + 空格不支持特殊符号 & ' 等，

2、认证被拒绝后，应该如何怎么处理？

可以通过接口修改账户实名或者重新创建

3、客户的证件过期了，应该怎么处理？

可以通过通知接口获取到实名过期的提醒，然后通过账户实名更新请求来更新过期后的实名信息。接口文档

贸易收款账户

1、都支持哪些收款国家？

收款国家参看以下地址，不定期更新

换汇

1、换汇交易是否有最大最小金额限制？

暂时无限制，建议大于等值100美金

2、换汇有营业时间限制吗？

工作日9:30-18:00为日间汇率，遇中国大陆和香港节假日不营业，遇美国、英国、欧洲等当地假期，该币种不交易

付款

1、什么是同名付款？什么情况下支持同名付款？

同名付款指的是付款人与虚拟账户的账户名一致，不会显示支付公司的名字。目前贸易付款账户均可以做到同名付款

2、付款有金额限制吗？

外币付款暂无限制，建议不小于等值 100 USD。

一、获取调用 API 访问凭证#

二、 API 地址#

三 、附录说明#

1. 调用流程#

2. 实名认证字段采集#

3. 申请收款账户字段#

4. 付款字段填写说明#

5. 异步回调#

四、API 调用流程#

五、常见问题#

一、获取调用 API 访问凭证

二、 API 地址

三、附录说明

1. 调用流程

2. 实名认证字段采集

3. 申请收款账户字段

4. 付款字段填写说明

5. 异步回调

四、API 调用流程

五、常见问题