拉卡拉銀聯二維碼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