6、卡券商品下单接口

创建于 2025-04-08 / 最近更新于 2025-08-18 / 376
字体： [默认] [大] [更大]
接口说明：卡券产品下单，须调用此接口，异步产品下单可能不会返回卡券内容，请使用订单查询接口查询结果

请求参数

参数

是否必填

类型

描述

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

订单金额

status

number

订单状态(3-处理中  4-已发货)

kami_style为1时，卡密返回格式（card）

参数

类型

描述

card_no

String

卡号

card_pass

String

密码

card_remark

String

备注

接口返回示例（默认卡密模式）

{
    "code": 0,
    "data": {
        "card": [
            "pZNH2aif6MSP",
            "8O5b0TfRAjnW"
        ],
        "money": 0.01,
        "status":4,
        "order_number": "1111"
    },
    "msg": "请求成功！"
}

接口返回示例（kami_style传1）

{
    "code": 0,
    "data": {
        "card": [
            {
                "card_no": "",
                "card_pass": "BytNVSFxSn1m",
                "card_remark": ""
            }
        ],
        "money": "0.0210",
         "status":4,
        "order_number": "202407031229451719580899"
    },
    "msg": "ok"
}


更新：2025.8.18 返回内容新增status订单状态字段，部分业务可能会存在返回卡券但订单仍然是未完成状态的场景，具体以订单状态为准。

0 人点赞过