一、接口目标用户及相关说明
汇款接口目标用户为所有开通了Omi-Transfer功能的OMIPAY注册商户。商户须在对应汇款币种的OMIPAY账户中有足够余额才能进行汇款操作。
二、接口支持货币
接口支持的汇款货币见下表:
| 货币代码 | 货币名称 |
| AUD | 澳元 |
三、接口规则
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×tamp&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 | 查询交易记录列表 |
![]()