2.1.25买币
接口地址:/openapi/card/buy/coin
请求方式:POST
请求数据类型:application/json
响应数据类型:application/json
接口描述:
法币购买数字货币；买币限制：
如果上次买币交易还没有完成，则不允许提交新的买币订单
请求示例:
{
"card_currency": "usd",
"card_id": "00003454323400000028888",
"currency_amount": "188",
"mc_trade_no": "48d2741747a4493223feb22",
"remark": "这是一个备注"
}
请求参数:
| 参数名称 | 数据类型 | 必须 | 参数说明 |
|---|---|---|---|
| card_currency | string | false | 卡币种；双币种卡才需要填写；最多10个字符；取值范围：usd，eur |
| card_id | string | true | 卡ID |
| currency_amount | string | true | 买币时支付的法币数量 |
| mc_trade_no | string | true | 交易流水，商户自定义，确保每笔交易此流水号唯一；最多128个字符 |
| remark | string | false | 交易备注，内容商户自定义；最多255个字符 |
响应参数:
| 参数名称 | 类型 | 参数说明 |
|---|---|---|
| code | string | 错误码 |
| data | object | 响应数据 |
| card_currency | string | 卡币种 |
| coin | string | 购买币种 |
| coin_amount | string | 到账金额，买币到账的数字货币金额 |
| create_time | string | 创建时间；精确到秒的时间戳 |
| currency_amount | string | 法币金额 |
| exchange_fee | string | 手续费 |
| status | integer | 交易状态；取值范围：0:待处理中,1:买币成功,2:买币失败 |
| tx_id | string | 交易流水号，由HyperCard生成，不超过64位字符 |
| reason | string | 失败原因 |
| msg | string | 错误信息 |
响应示例:
{
"code": "00000",
"data": {
"card_currency": "usd",
"coin": "usdt",
"coin_amount": "188.88",
"create_time": "1595497477",
"currency_amount": "188",
"exchange_fee": "0.88",
"status": 0,
"tx_id": "202211231505292302221643837177",
"reason": ""
},
"msg": "ok"
}