OMI-Transfer 商户汇款API接口

一、接口目标用户及相关说明

汇款接口目标用户为所有开通了Omi-Transfer功能的OMIPAY注册商户。商户须在对应汇款币种的OMIPAY账户中有足够余额才能进行汇款操作。

 

二、接口支持货币

接口支持的汇款货币见下表:

货币代码 货币名称
AUD 澳元

收款货币见《Omi-Transfer Playbook

 

三、接口规则

3.1协议规则

名称 内容
访问方式 Web API
传输协议 HTTPS
提交方式 HTTP POST
数据格式 请求返回数据为Json格式
字符编码 UTF-8
Http Header ContentType=application/json
超时设定 请求超时时间为5分钟,即服务器请求接收时间与时间戳标识时间间隔需要小于5分钟。
签名算法 签名算法为MD5

 

3.2参数约定

1)金额

金额单位为对应币种的标准单位。

2)时间

系统中所有时间为澳洲东部时间AEST。

3)时间戳

UTC标准时间,自1970年1月1日0点0分0秒以来的毫秒数。

 

3.3安全验证

接口调用时需要进行签名。签名方法如下:

1) 参与签名字段

参与签名字段如下:

字段名 类型 说明
m_number String 商户编号。OMIPAY商户的唯一编号
timestamp Long 时间戳,见参数规定中的时间戳
nonce_str String 随机字符串,10-32位随机码,允许使用a-z | A-Z | 0-9字符。用于保证签名的不可预测性。推荐使用随机数算法生成。
secret_key String 商户API密钥。可在商户后台中获取。

 

2) 生成签名

将以上字段按照m_number&timestamp&nonce_str&secret_key方式进行拼接(顺序一定要正确),之后用MD5算法对拼接后的字符串进行摘要,然后转成大写,得到签名字符串。

 

3) 将签名字符串以sign为key,包含在接口参数中进行请求。

四、接口内容

OMI-Transfer商户汇款API包含如下接口:

接口名称 说明
1 Create Recipient 创建收款人
2 Query Recipients 查询收款人信息
3 Pre-Create Send 汇款预下单
4 Send 汇款下单
5 Cancel 取消汇款
6 Query Send 查询汇款状态及信息
7 Account List 获取账户列表
8 Account Balance 查询账户余额
9 Send List 查询交易记录列表



发表评论

邮箱地址不会被公开。 必填项已用*标注