商户给用户打款

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(转帐失败)