拉卡拉银联二维码3C国补核销
调用地址
测试环境：https://test.wsmsd.cn/sit/api/v3/labs/query/get_product_gsp
生产环境：https://s2.lakala.com/api/v3/labs/query/get_product_gsp
调用说明：
1、查询；2、占用功能，需在银联交易发起前置完成调用；
3、撤销；需完成银联交易退货后发起调用；
1. 查询核销
看这个SN有没有被核销，发起机构主动发起SN码是否已核销接口查询，判断3C产品是否可以参加国补
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|---|---|---|---|
| biz_method | 接口类型 | M | String(128) | query:是否已核销 occupancy：占用变更 release.释放变更 |
| region_cd | 地区码 | M | String(6) | 参考中华人民共和国行政区划代码 |
| sn_code | sn码 | M | String(32) | |
| merchant_no | 商户号 | M | String(24) | |
| type | 类型 | C | String(8) | 01:线上交易 |
2. 占用
支付前需要占用下SN，这样该省份内就不能再占用了；机构主动发起SN码占用变更接口，为参加国补的3C产品占坑
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|---|---|---|---|
| biz_method | 接口类型 | M | String(128) | query:是否已核销 occupancy：占用变更 release.释放变更 |
| region_cd | 地区码 | M | String(6) | 参考中华人民共和国行政区划代码 |
| sn_code | sn码 | M | String(32) | |
| merchant_no | 商户号 | M | String(24) | |
| term_no | 终端号 | M | String(256) | |
| barcode | 商品条码 | M | String(14) | 若条码不满14位则在前补0至14位 |
| txn_time | 请求时间 | M | String(16) | yyyyMMddHHmmss |
| sale_Tm | 销售时间 | M | String(16) | yyyy-MM-dd 2024-12-22（同下单时间） |
| trade_no | 交易订单号 | M | String(64) | |
| imei1 | IMEI1码 | C | String(32) | |
| imei2 | IMEI1码 | C | String(32) | |
| req_reserved | 请求方保留域 | C | String(128) | |
| type | 类型 | C | String(8) | 01:线上交易 |
3. 释放
退货或者撤销的时候，把SN的状态变更；是发起机构主动发起SN码释放变更接口，3C产品的SN释放
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|---|---|---|---|
| biz_method | 接口类型 | M | String(128) | query:是否已核销 occupancy：占用变更 release.释放变更 |
| merchant_no | 商户号 | M | String(24) | |
| region_cd | 地区码 | M | String(6) | 参考中华人民共和国行政区划代码 |
| trade_no | 交易订单号 | M | String(64) | |
| sn_code | sn码 | M | String(32) | |
| txn_time | 请求时间 | M | String(16) | yyyyMMddHHmmss |
| req_reserved | 请求方保留域 | C | String(128) |
响应参数
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|---|---|---|---|
| sub_code | 详细应答码 | C | String(32) | 1.是否已核销： 000000 可售 000001 不可售 2.占用变更：000000 占用成功000001 占用失败000002 占用成功999999 占用异常 3.释放变更:000000 释放成功000001 释放失败 999999 释放异常 |
| sub_msg | 详细应答码 | C | String(32) |
示例
查询
请求报文:
{
"req_time":"202501132020",
"version":"1.0.0",
"req_data": {
"biz_method": "query",
"region_cd": "310115",
"sn_code": "ABCDE10001000001000055",
"merchant_no":"82222222222541141",
"req_reserved": ""
}
}复制响应报文:
{
"code": "BBS00000",
"msg": "成功",
"resp_data": {
"sub_code": "000000",
"sub_msg": "可售"
},
"resp_time": "20250113140631"
}复制占用
请求报文:
{
"req_time":"202501132020",
"version":"1.0.0",
"req_data": {
"biz_method": "occupancy",
"txn_time":"20241222202020",
"trade_no":"2025012066200618380538",
"merchant_no":"8221210594300K3",
"barcode":"20241222202666",
"region_cd": "310115",
"term_no": "LCYWAK73",
"sn_code": "ABCDE10001000001000666",
"sale_Tm":"2024-12-22"
}
}复制响应报文:
{
"code": "BBS00000",
"msg": "成功",
"resp_data": {
"sub_code": "000000",
"sub_msg": "占用成功"
},
"resp_time": "20250113140631"
}复制释放
请求报文:
{
"req_time":"202501132020",
"version":"1.0.0",
"req_data": {
"biz_method": "release",
"trade_no":"2025012066200618380538",
"txn_time":"20241222202020",
"region_cd": "310115",
"sn_code": "ABCDE10001000001000666",
"merchant_no":"8221210594300K3"
}
}复制响应报文:
{
"code": "BBS00000",
"msg": "成功",
"resp_data": {
"sub_code": "000000",
"sub_msg": "释放成功"
},
"resp_time": "20250113140631"
}The End