3、校验地址

3.1 场景说明

可校验各个币种的地址格式是否符合正确. 本接口不是必需接口, 可酌情接入.

用例: 用户在商户自家平台进行提币操作, 填写了币种:BTC, 地址:11111, 商户调用本接口, 便可知道用户填写的地址格式错误, 方便提醒用户.

3.2 接口详情

3.2.1 接口地址

接口详情
URL /api/check
请求方式 GET

3.2.2参数

3.2.2.1参数说明

参数 类型 是否必填 说明 备注
currency String 币种名
address String 地址

3.2.2.2 请求示例

{  
  "address":"r3ReqczYCCc44pUxU9bmWauCSzJJoiy2oD",
  "currency":"XRP",
}
								

3.2.2.3 成功响应示例

{
  "code": "200",
  "message": "SUCCESS"
}
								

3.2.2.4异常响应示例查看

{
  "code": "550",
  "message": "地址校验失败",
  "data": null
}
								

4、获取币种列表

4.1 场景说明

可获取所有币种列表

4.2 接口详情

4.2.1 接口地址

接口详情
URL /api/currency
请求方式 GET

4.2.2参数

4.2.2.3响应示例

{
  "code": "200",
  "message": "SUCCESS",
  "data": [
    {
      "logo": "https://vvvzhangshuo.oss-cn-shanghai.aliyuncs.com/images/BTC.png", //币种logo
      "name": "BTC"  //币种名
    },   
    {
      "logo": "https://vvvzhangshuo.oss-cn-shanghai.aliyuncs.com/images/XRP.png",
      "name": "XRP"
    },
    {
      "logo": "https://vvvzhangshuo.oss-cn-shanghai.aliyuncs.com/images/LTC.png",
      "name": "LTC"
    }   
  ]
}
								

5、回调

5.1 场景说明

本系统调用商户提供的回调接口,通知商户地址查看的充值和提现具体变化信息。

如果商户提供的回调接口异常, 本平台将保存异常的回调. 同时, 商户后台提供了重新发送失败回调的功能, 可保证您的每笔充提都万无一失

5.2 接口详情

5.2.1 接口地址

接口详情
URL
请求方式 POST
Content-Type application/x-www-form-urlencoded; charset=utf-8

5.2.2参数

5.2.2.1参数说明

参数 类型 说明 备注
id String 支付平台内部交易号
merchant_id String 商家在支付平台的ID
user_id String
trade_id String 提币交易传此信息
currency String 币种名
tx_type String 交易类型 “recharge” : 充币,“cash” : 提币, 本参数非常重要
tx_hash String 区块链交易哈希 区块浏览器可通过本参数的值查询到本交易
tx_time Long 区块链交易时间(时间戳) 单位秒, 本参数较为重要
height Integer 交易的区块高度 一个区块由多个交易组成, 在区块浏览器中, 查询本参数的值可以找到本交易(如果该区块交易过多,这可能要花费很长时间)
from_account String 转账发起者地址 本参数可能为空
to_account String 收款地址
amount String 金额 金额
status String 状态
create_time String 记录创建时间 单位秒
timestamp String 时间戳(系统时间) 单位秒
sign String sra签名

将各个参数的值拼接后,对其进行sra 加密, 得到sign

注意: 参与md5签名计算的参数必须按照如下(ASCII顺序表 + apikey)顺序拼接,否则会导致验签不匹配

sign= sra(amount+ blockHigh + businessId + confirmHeight+ createTime + currency + fromAddress + maxConfirmHeight + msg + nonce + status + timeStamp + toAddress + tradeId + tradeType + txid + txTime + apikey)

注意: 计算sign时, 如果某项参数为空, 则对应的值为 “”, 而不是 “null” 或者 “ “

5.2.2.2回调 请求示例

{
 "amount": "100",
 "blockHigh": "3415249",
 "businessId": "12412512",
 "currency": "DOGE",
 "createTime": "1601200752",
 "confirmHeight": "3",
 "fromAddress": "",
 "maxConfirmHeight": "3",
 "msg": "",
 "status": "1",
 "txid": "0ae988306fdff6edcd3d0a7ebdffa4d12df2c13848a9ed790844ea05091ddb5a",
 "txTime": "1601200752",
 "tradeId": "dd90909110ba40c6890e762992b8fc95",
 "tradeType": "WITHDRAW",
 "toAddress": "DKoWbr4oWGyZwDdYFbAG74nPtTdGsWon9G",
 "nonce": "1310157031952891904",
 "timestamp": "1601200800",
 "sign": "291332420a986cdb8119f24d880463e0"
}

								

5.2.2.3 回调响应

只要商户提供的回调接口响应状态码Status为200, 便视为回调发送成功. 如果回调发送失败, 将会每10秒重发一次, 重新发送20次.

5.2.2.4 回调接口状态说明

状态 说明
0 等待交易
1 交易中
2 交易完成
3 交易失败

附录

返回状态码

code 解释
200 成功
301 币种名不能为空
303 系统正在升级,请稍后重试
401 验签失败
500 内部错误
534 该地址已分配为您的商户后台充币地址,请在商户后台网站中查看
535 提币金额小于等于0
536 提币金额小于最小提币限额,或大于最大提币限额
537 当日提币金额大于当日最大提币限额
538 提币金额大于可用金额
539 用户地址数量达到上限,请先解锁地址数量限制
545 提币唯一ID已被提交,为避免商家误操作,此次提币不会被受理
550 地址效验失败
990 请求Content-Type不为application/json或参数类型错误

一个覆盖全球的币支付平台,致力于解决企业全球收款问题,为企业提供安全,便捷,保护隐私的区块链在线支付服务,企业可通过支付平台选择稳定币,比特币以及其他代币在全球范围内完成收款和支付,更容易把业务拓展全球,实现改善。

支持币种

联系我们-飞机:@wohui