文档
测试

提交卡密

POST
https://www.kabaojiedan.com/public/openapi_qy/api_submit

请求参数

参数名
类型
描述
必填
access_key
string
开发者账号(KB后台->活动中心->API接口合作中获取)
必填
sign
string
密钥签名(生成算法请参见目录文档《密钥签名》)
必填
brand_id
integer
权益品牌编号(编号请参见目录文档《品牌列表》)
必填
par
float
寄售产品面值,单位:元 (如一百元面值:100.00)
必填
discount
integer
折扣,该值范围0-10000(例子:假如折扣是0.9858/98.58%,则传9858) 默认0表示官方默认折扣
可选
card_no
string
卡号(选填,如果有必填)
可选
card_pwd
string
卡密/兑换码/激活码/链接(内容需要AES加密,加密方法请参见文档下方内容)
必填
third_order_id
string
业务方自定义订单号
可选
callback_url
string
回调地址(请带上http),订单状态变更时会主动推送通知
可选
attach
string
该参数在回调时原样返回
可选

响应参数

application/json
参数名
类型
描述
必填
code
integer
提交结果(1:成功, 其它:失败)
可选
msg
string
提示错误信息,成功为空
可选
success
integer
成功提交数量
可选
data
json
返回数据
可选
cards
array
成功提交的卡密列表
必填
order_id
integer
KB订单编号(订单查询会用到)
必填
card_value
string
提交卡密内容(如有卡号将会是:卡号|卡密)
必填

说明 / 示例

请求: ```language URL: https://www.kabaojiedan.com/public/openapi_qy/api_submit { "access_key": "2112136711566", "brand_id": 204286516, "sign": "026e966532d04651cbb786986d2dbb1f", "par": 100, "discount": 9188, "card_no": "2326992160003061776", "card_pwd": "8CRNG3pt3MvqdfzaQb/9/g==", "third_order_id": "1714116053", "callback_url": "https://aaa.xxx.com/callback" "attach": "test" } ``` 成功返回: ```language { "code":1, "msg":"", "success":1, "data":{ "cards":[ { "order_id":"191694", "card_value":"2326992160003061776|testpasswd" } ] } } ``` 错误返回: ```language { "code":3, "msg":"错误的SKU信息", "success":0, "data":{} } ``` 【card_pwd加密方法-PHP示例】 友情提示:$app_secret请到KB后台->活动中心->API接口合作中获取 ```language // 敏感信息加密方法 function aes_encrypt($data) { $key = substr(md5($app_secret), 0, 16); return base64_encode(openssl_encrypt($data, "AES-128-CBC", $key, TRUE, "0102030405060708")); } // 敏感信息解密算法 function aes_decrypt($data) { $key = substr(md5($app_secrett), 0, 16); return openssl_decrypt(base64_decode($data), "AES-128-CBC", $key, TRUE, "0102030405060708"); } ```