6、卡券商品下单接口
接口说明:卡券产品下单,须调用此接口,异步产品下单可能不会返回卡券内容,请使用订单查询接口查询结果
请求参数
参数 | 是否必填 | 类型 | 描述 |
appid | 是 | String | appid |
time | 是 | String | 10位当前时间戳,间隔上下不低于120秒 |
sign | 是 | String | 签名,规则参照签名规则 |
method | 是 | String | youquanyi.api.out.buykami |
count | 是 | String | 购买数量 |
cus_order_no | 是 | String | 客户端订单号,不能重复 |
good_id | 是 | String | 下单产品ID |
safe_price | 否 | String | 订单总价,用于防止亏本下单,为空或不传则不执行 |
kami_style | 否 | String | 卡密返回格式,不传按模式格式返回,传1将按照卡号,密码,备注格式返回卡密,参考下方返回示例 |
请求示例
{
"appid": 'xxxxxxx',
"time": "1695006965",
"count": "1",
"cus_order_no": "111",
"good_id": "122",
"safe_price":"2.31",
"method": "youquanyi.api.out.buykami",
"sign": "签名内容,请阅读签名方法"
}
公共响应参数
参数 | 类型 | 描述 |
code | Number | 返回码 0-成功 99-失败 |
msg | String | 提示信息 |
data | String | 业务返回数据 |
业务返回参数(data)
参数 | 类型 | 描述 |
order_number | String | 订单号 |
card | String | 卡券内容,如果为异步产品,不会立刻返回,请通过订单接口查询 |
money | String | 订单金额 |
kami_style为1时,卡密返回格式(card)
参数 | 类型 | 描述 |
card_no | String | 卡号 |
card_pass | String | 密码 |
card_remark | String | 备注 |
接口返回示例(默认卡密模式)
{
"code": 0,
"data": {
"card": [
"pZNH2aif6MSP",
"8O5b0TfRAjnW"
],
"order_number": "1111",
"money": 0.01
},
"msg": "请求成功!"
}
接口返回示例(kami_style传1)
{
"msg": "ok",
"code": 0,
"data": {
"order_number": "202407031229451719580899",
"card": [
{
"card_no": "",
"card_pass": "BytNVSFxSn1m",
"card_remark": ""
}
],
"money": "0.0210"
}
}