商户给用户打款¶
1. 开发须知¶
1.1 应用场景¶
- 用户发起提现
- 给用户发放红包
- 用户退款
1.2 接口域名¶
第三方服务端直接调用。例如：商户服务端、游戏方服务端、第三方平台服务端
测试环境: http://avenger.hicoin.one/api
生产环境: https://avenger.hicoin.vip/api
2. 获取基础授权token¶
| 说明: | 获取基础token，注意：需提前将服务器IP地址添加到IP白名单中 |
|---|---|
| 接口地址: | /cgi-bin/access_token |
| 请求方式: | POST |
| 请求参数: |
| 参数名 | 数据类型 | 是否必须 | 说明 |
| app_id | string | 是 | 第三方标识 |
| secret | string | 是 | 第三方key |
| grant_type | string | 是 | 填写为client_credential |
| 响应参数: |
|---|
| 参数名 | 数据类型 | 是否必须 | 说明 |
| access_token | string | 是 | 基础access_token |
| expires_in | string | 是 | access_token接口调用凭证超时时间，单位（秒） |
3. 商户给用户打款¶
| 说明: | 商户给用户打款, 注意此接口需要公共参数 |
|---|---|
| 接口地址: | /mmpaymkttransfers/promotion/transfers |
| 请求方式: | POST |
| 请求参数: |
| 参数名 | 数据类型 | 是否必须 | 说明 |
| app_id | string | 是 | 应用ID |
| access_token | string | 是 | 基础access_token |
| lang | string | 是 | i18n 语言,固定zh_CN |
| version | string | 是 | 接口版本固定1.0 |
| charset | string | 是 | 固定utf8 |
| nonce_str | string | 是 | 32位随机数 |
| sign | string | 是 | 参数签名 |
| biz_content | string | 是 | 业务请求参数的集合json |
biz_content结构体
| 参数名 | 数据类型 | 是否必须 | 说明 |
| openid | string | 是 | 用户openid |
| body | string | 是 | 订单说明 |
| subject | string | 是 | 订单标题 |
| out_trade_no | string | 是 | 第三方网站唯一订单号，32字符0-9A-Za-z |
| total_amount | long | 是 | 支付币种数量，所有币种使用8位精度，如1eth则传100000000 |
| settle_currency | string | 是 | 支付币种大写，USDT |
| 响应参数: |
|---|
| 参数名 | 数据类型 | 是否必须 | 说明 |
| out_trade_no | string | 是 | 第三方网站唯一订单号 |
| trade_no | string | 是 | 平台订单号(prepay_id) |
| trade_type | string | 是 | JSAPI、H5 |
| nonce_str | string | 是 | 32位随机数 |
| sign | string | 是 | 返回数据签名 |
4. 商户给用户打款订单查询¶
| 说明: | 商户给用户打款订单查询 |
|---|---|
| 接口地址: | /mmpaymkttransfers/gettransferinfo |
| 请求方式: | POST |
| 请求参数: |
| 参数名 | 数据类型 | 是否必须 | 说明 |
| app_id | string | 是 | 应用ID |
| access_token | string | 是 | 基础access_token |
| lang | string | 是 | i18n 语言,固定zh_CN |
| version | string | 是 | 接口版本固定1.0 |
| charset | string | 是 | 固定utf8 |
| nonce_str | string | 是 | 32位随机数 |
| sign | string | 是 | 参数签名 |
| biz_content | string | 是 | 业务请求参数的集合json |
biz_content结构体
| 参数名 | 数据类型 | 是否必须 | 说明 |
| out_trade_no | string | 是 | 第三方网站唯一订单号 |
| 响应参数: |
|---|
| 参数名 | 数据类型 | 是否必须 | 说明 |
| out_trade_no | string | 是 | 第三方网站唯一订单号 |
| trade_no | string | 是 | 平台订单号(prepay_id) |
| trade_status | string | 是 | 订单状态,SUCCESS（转账成功）， FAILED(转帐失败) |
| reason | string | 是 | 失败原因，如：商户余额不足 |
| total_amount | long | 是 | 订单币种数量,精度8位 |
| settle_currency | string | 是 | 购买币种：固定为USDT |
| settle_trans_amount | long | 是 | 实际打币数量,精度8位 |
| subject | string | 是 | 订单标题 |
| body | string | 是 | 订单说明 |
| trade_time | string | 是 | 订单时间 |
| openid | string | 是 | 用户openid |
| nonce_str | string | 是 | 32位随机数 |
| sign | string | 是 | 返回数据签名 |
重点字段说明：
- trade_status: SUCCESS（转账成功）， FAILED(转帐失败)