拉卡拉銀聯(lián)二維碼3C國(guó)補(bǔ)核銷
調(diào)用地址
測(cè)試環(huán)境：https://test.wsmsd.cn/sit/api/v3/labs/query/get_product_gsp
生產(chǎn)環(huán)境：https://s2.lakala.com/api/v3/labs/query/get_product_gsp
調(diào)用說明：
1、查詢；2、占用功能，需在銀聯(lián)交易發(fā)起前置完成調(diào)用；
3、撤銷；需完成銀聯(lián)交易退貨后發(fā)起調(diào)用；
1. 查詢核銷
看這個(gè)SN有沒有被核銷，發(fā)起機(jī)構(gòu)主動(dòng)發(fā)起SN碼是否已核銷接口查詢，判斷3C產(chǎn)品是否可以參加國(guó)補(bǔ)
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|---|---|---|---|
| biz_method | 接口類型 | M | String(128) | query:是否已核銷 occupancy：占用變更 release.釋放變更 |
| region_cd | 地區(qū)碼 | M | String(6) | 參考中華人民共和國(guó)行政區(qū)劃代碼 |
| sn_code | sn碼 | M | String(32) | |
| merchant_no | 商戶號(hào) | M | String(24) | |
| type | 類型 | C | String(8) | 01:線上交易 |
2. 占用
支付前需要占用下SN，這樣該省份內(nèi)就不能再占用了；機(jī)構(gòu)主動(dòng)發(fā)起SN碼占用變更接口，為參加國(guó)補(bǔ)的3C產(chǎn)品占坑
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|---|---|---|---|
| biz_method | 接口類型 | M | String(128) | query:是否已核銷 occupancy：占用變更 release.釋放變更 |
| region_cd | 地區(qū)碼 | M | String(6) | 參考中華人民共和國(guó)行政區(qū)劃代碼 |
| sn_code | sn碼 | M | String(32) | |
| merchant_no | 商戶號(hào) | M | String(24) | |
| term_no | 終端號(hào) | M | String(256) | |
| barcode | 商品條碼 | M | String(14) | 若條碼不滿14位則在前補(bǔ)0至14位 |
| txn_time | 請(qǐng)求時(shí)間 | M | String(16) | yyyyMMddHHmmss |
| sale_Tm | 銷售時(shí)間 | M | String(16) | yyyy-MM-dd 2024-12-22（同下單時(shí)間） |
| trade_no | 交易訂單號(hào) | M | String(64) | |
| imei1 | IMEI1碼 | C | String(32) | |
| imei2 | IMEI1碼 | C | String(32) | |
| req_reserved | 請(qǐng)求方保留域 | C | String(128) | |
| type | 類型 | C | String(8) | 01:線上交易 |
3. 釋放
退貨或者撤銷的時(shí)候，把SN的狀態(tài)變更；是發(fā)起機(jī)構(gòu)主動(dòng)發(fā)起SN碼釋放變更接口，3C產(chǎn)品的SN釋放
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|---|---|---|---|
| biz_method | 接口類型 | M | String(128) | query:是否已核銷 occupancy：占用變更 release.釋放變更 |
| merchant_no | 商戶號(hào) | M | String(24) | |
| region_cd | 地區(qū)碼 | M | String(6) | 參考中華人民共和國(guó)行政區(qū)劃代碼 |
| trade_no | 交易訂單號(hào) | M | String(64) | |
| sn_code | sn碼 | M | String(32) | |
| txn_time | 請(qǐng)求時(shí)間 | M | String(16) | yyyyMMddHHmmss |
| req_reserved | 請(qǐng)求方保留域 | C | String(128) |
響應(yīng)參數(shù)
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|---|---|---|---|
| sub_code | 詳細(xì)應(yīng)答碼 | C | String(32) | 1.是否已核銷： 000000 可售 000001 不可售 2.占用變更：000000 占用成功000001 占用失敗000002 占用成功999999 占用異常 3.釋放變更:000000 釋放成功000001 釋放失敗 999999 釋放異常 |
| sub_msg | 詳細(xì)應(yīng)答碼 | C | String(32) |
示例
查詢
請(qǐng)求報(bào)文:
{
"req_time":"202501132020",
"version":"1.0.0",
"req_data": {
"biz_method": "query",
"region_cd": "310115",
"sn_code": "ABCDE10001000001000055",
"merchant_no":"82222222222541141",
"req_reserved": ""
}
}復(fù)制響應(yīng)報(bào)文:
{
"code": "BBS00000",
"msg": "成功",
"resp_data": {
"sub_code": "000000",
"sub_msg": "可售"
},
"resp_time": "20250113140631"
}復(fù)制占用
請(qǐng)求報(bào)文:
{
"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"
}
}復(fù)制響應(yīng)報(bào)文:
{
"code": "BBS00000",
"msg": "成功",
"resp_data": {
"sub_code": "000000",
"sub_msg": "占用成功"
},
"resp_time": "20250113140631"
}復(fù)制釋放
請(qǐng)求報(bào)文:
{
"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"
}
}復(fù)制響應(yīng)報(bào)文:
{
"code": "BBS00000",
"msg": "成功",
"resp_data": {
"sub_code": "000000",
"sub_msg": "釋放成功"
},
"resp_time": "20250113140631"
}The End