聚合收銀臺(tái)收銀臺(tái)訂單創(chuàng)建 (全報(bào)文加密)
調(diào)用地址
自2024年1月16日起,請(qǐng)通過(guò)以下接口進(jìn)行接入:
使用HTTP協(xié)議,POST方式提交。
URL(測(cè)試環(huán)境外網(wǎng)):https://test.wsmsd.cn/sit/api/v3/ccss/counter/order/special_create_encry
URL(生產(chǎn)環(huán)境):https://s2.lakala.com/api/v3/ccss/counter/order/special_create_encry
商戶需在微信商家后臺(tái)配置以下支付域名(原支付目錄),2023 年 9 月后入網(wǎng)的商戶可忽略此配置:
生產(chǎn)環(huán)境訂單域名:pay.lakala.com
測(cè)試環(huán)境訂單域名:pay.wsmsd.cn
請(qǐng)求參數(shù)
| 字段名 | 是否必輸 | 類型 | 長(zhǎng)度 | 字段描述 | 示例 |
|---|---|---|---|---|---|
| out_order_no | M | String | 32 | 商戶訂單號(hào) | 12345678 |
| merchant_no | M | String | 32 | 商戶號(hào) | 822100041120005 |
| vpos_id | C | String | 32 | 交易設(shè)備標(biāo)識(shí)(非合單場(chǎng)景必輸該字段),進(jìn)件返回接口中的termId字段,非API接口進(jìn)件請(qǐng)聯(lián)系業(yè)務(wù)員。 | 462621830268882944 |
| channel_id | C | String | 32 | 渠道號(hào) (一般不用) | 24865454154 |
| busi_mode | C | String | 8 | 業(yè)務(wù)模式: ACQ-收單 PAY-付款 不填,默認(rèn)為“ACQ-收單” | |
| total_amount | M | long | 12 | 訂單金額,單位:分。JPY和KRW的單位是元,即200日元,填“200" | 200 |
| order_efficient_time | M | String | 14 | 訂單有效期 格式y(tǒng)yyyMMddHHmmss,最大支持下單時(shí)間+2天 | 20210803141700 |
| notify_url | C | String | 128 | 訂單支付成功后商戶接收訂單通知的地址 http://xxx.xxx.com | |
| support_cancel | C | int | 1 | 是否支持撤銷 默認(rèn) 0 不支持 busi_mode為“PAY-付款”不支持 撤銷 | (0 不支持 1支持) |
| support_refund | C | int | 1 | 是否支持退款 默認(rèn)0 不支持 | (0 不支持 1支持) |
| support_repeat_pay | C | int | 1 | 是否支持“多次發(fā)起支付” 默認(rèn)0 不支持 | (0 不支持 1支持) |
| out_user_id | C | String | 64 | 發(fā)起訂單方的userId,歸屬于channelId下的userId | |
| callback_url | C | String | 128 | 客戶端下單完成支付后返回的商戶網(wǎng)頁(yè)跳轉(zhuǎn)地址。 | |
| order_info | M | String | 64 | 訂單標(biāo)題,在使用收銀臺(tái)掃碼支付時(shí)必輸入,交易時(shí)送往賬戶端 | |
| term_no | C | String | 32 | 結(jié)算終端號(hào),合單場(chǎng)景必輸該字段 | |
| split_mark | C | String | 2 | 合單標(biāo)識(shí),“1”為合單,不填默認(rèn)是為非合單 | |
| settle_type | C | String | 4 | 結(jié)算類型(非合單) (“0”或者空,常規(guī)結(jié)算方式) 注意:該字段會(huì)影響結(jié)算方式,慎用。(調(diào)用拉卡拉分賬接口需必傳) | |
| out_split_info | C | List<> | 拆單信息 合單標(biāo)識(shí)為“1”時(shí)必傳該字段。,詳細(xì)字段見(jiàn)out_split_info字段說(shuō)明 | ||
| counter_param | C | String | 1024 | 收銀臺(tái)展示參數(shù) | {\“pay_mode\“ : \“ALIPAY\“} ,指定支付方式為支付寶 ALIPAY:支付寶 WECHAT:微信 UNION:銀聯(lián)云閃付 CARD:POS刷卡交易 LKLAT:線上轉(zhuǎn)帳 QUICK_PAY:快捷支付 ONLINE_CARDLESS:線上外卡 若要指定支付方式為支付寶傳參格式: |
| counter_remark | C | String | 128 | 收銀臺(tái)備注 | |
| busi_type_param | C | String | 256 | 業(yè)務(wù)類型控制參數(shù),jsonStr格式 | [{\“busi_type\“:\“UPCARD\“,\“params\“:{\“crd_flg\“:\“CRDFLG_D|CRDFLG_C|CRDFLG_OTH\“}},{\“busi_type\“:\“SCPAY\“,\“params\“:{\“pay_mode\“:\“ALIPAY\“,\“crd_flg\“:\“CRDFLG_D\“}},{\“busi_type\“:\“DCPAY\“,\“params\“:{\“pay_mode\“:\“DCPAY\“}}] 說(shuō)明:UPCARD-刷卡,SCPAY-掃碼,DCPAY-數(shù)幣 CRDFLG_D-借記卡,CRDFLG_C-貸記卡,CRDFLG_OTH-不明確是借記卡還是貸記卡 pay_mode送參說(shuō)明:ALIPAY-支付寶,WECHAT-微信,UNION-銀聯(lián)二維碼,DCPAY-數(shù)字貨幣,BESTPAY-翼支付 說(shuō)明:一旦使用該字段,則增加限制,必須在指定限制范圍內(nèi)支付。比如,只配置”busi_type”:”UPCARD”的參數(shù)而不配置”busi_type”:”SCPAY”的參數(shù),則只能通過(guò)刷卡而不能通過(guò)掃碼完成支付 |
| sgn_info | C | list<> | 簽約協(xié)議號(hào)列表(字符串) | [“1234”,”2345”],不支持空列表[];列表中簽約協(xié)議號(hào)不能為空;列表中簽約協(xié)議號(hào)不能重復(fù) | |
| transfer_field | C | Object | 轉(zhuǎn)賬支付時(shí)可以上送,詳細(xì)字段見(jiàn)transfer_field字段說(shuō)明 | ||
| identity_info | C | String | 128 | 實(shí)名信息 json字符串 | {\“identityNo\“:\“32000000000000000X\“,\“name\“:\“張三\“,\“identityType\“:"01\“} 證件類型 01:身份證 02:軍官證 03:護(hù)照 04:港澳證(港澳居民來(lái)往內(nèi)地通行證/回鄉(xiāng)證) 05:臺(tái)胞證 06:警官證 07:士兵證 99:其它證件 目前僅支持證件類型為01-身份證 |
| product_id | C | String | 6 | 指定產(chǎn)品編號(hào) (200809:線上外卡收銀臺(tái)) 注意:該字段默認(rèn)不需要指定,特殊場(chǎng)景下使用,慎用。 | |
| goods_mark | C | String | 2 | 商品信息標(biāo)識(shí) (1:外卡交易商品下單,不填默認(rèn)不送商品信息) | |
| goods_field | C | String | 2048 | json字符串,商品信息域(good_mark送1時(shí)該域必填,否則不送。只有線上外卡業(yè)務(wù)上送該字段) 詳細(xì)字段見(jiàn)goods_field字段說(shuō)明 | |
| order_scene_field | C | Object | 訂單場(chǎng)景域,特殊場(chǎng)景下需要上送 詳細(xì)字段見(jiàn)order_scene_field字段說(shuō)明 | ||
| trans_currency | C | String | 幣種(三位數(shù)字),參見(jiàn)國(guó)標(biāo),默認(rèn)值:156 詳細(xì)見(jiàn)trans_currency字段說(shuō)明 | 特定場(chǎng)景下使用 | |
| discount_code | C | String | 64 | 優(yōu)惠碼(目前供線上國(guó)補(bǔ)下單使用) | |
| customer_info | C | String | 1024 | 用戶信息域(目前供線上國(guó)補(bǔ)下單使用) | 示例:{\“certifTp\“:\“22222\“,\“certifId\“:\“1111\“,\“customerNm\“:\“333\“,\“smsCode\“:\“888\“,\“pin\“:\“777\“,\“cvn2\“:\“444\“,\“expired\“:\“555\“,\“phoneNo\“:\“666\“} |
| electrical_equipment_category | C | String | 128 | 支付寶優(yōu)惠碼(目前優(yōu)惠碼的地區(qū):浙江、江蘇、上海、福建、重慶) |
out_split_info字段說(shuō)明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說(shuō)明 |
|---|---|---|---|---|
| out_sub_order_no | 外部子訂單號(hào) | M | String(32) | 商戶子訂單號(hào) |
| merchant_no | 商戶號(hào) | M | String(32) | 拉卡拉分配的商戶號(hào) |
| term_no | 終端號(hào) | M | String(32) | 拉卡拉分配的業(yè)務(wù)終端號(hào) |
| amount | 金額 | M | String(12) | 單位分,整數(shù)型字符 |
| settle_type(計(jì)劃中) | 結(jié)算類型(合單) | C | String(4) | “0”或者空,常規(guī)結(jié)算方式 |
| sub_remark | 子單備注 | C | String(64) | 子單備注 |
transfer_field字段說(shuō)明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說(shuō)明 |
|---|---|---|---|---|
| acc_out_no | 付款人賬號(hào) | C | String(32) | 付款人賬號(hào) 上送則校驗(yàn) |
| acc_out_name | 付款人姓名 | C | String(64) | 付款人姓名 上送則校驗(yàn) |
| additional | 轉(zhuǎn)賬附言 | C | String(128) | 轉(zhuǎn)賬附言 上送則校驗(yàn) |
goods_field字段說(shuō)明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說(shuō)明 |
|---|---|---|---|---|
| goods_amt | 商品單價(jià) | M | Long | 單位:分 |
| goods_num | 商品數(shù)量 | M | Integer | |
| goods_pricing_unit | 商品計(jì)價(jià)單位 | M | String(8) | 1-箱 2-件 3-瓶 4-個(gè) |
| goods_name | 商品名稱 | M | String(128) | |
| te_platform_type | 交易電商平臺(tái)類型 | M | String(2) | 1-境內(nèi)平臺(tái) 2-境外平臺(tái) |
| te_platform_name | 交易電商平臺(tái)名稱 | M | String(256) | |
| goods_type | 交易商品類型 | M | String(8) | 1:服飾箱包 2:食品藥品 3:化妝品 4:電子產(chǎn)品 5:日用家居 7:航空機(jī)票 8:酒店住宿 9:留學(xué)教育 10:旅游票務(wù) 11:國(guó)際物流 12:國(guó)際租車(chē) 13:國(guó)際會(huì)議 14:軟件服務(wù) 15:醫(yī)療服務(wù) 16:通訊 17:休閑娛樂(lè) |
order_scene_field字段說(shuō)明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說(shuō)明 |
|---|---|---|---|---|
| order_scene_type | 訂單場(chǎng)景類型 | M | String(16) | 訂單場(chǎng)景類型(按下述定義場(chǎng)景送值) ONLINE_WILDCARD:線上外卡場(chǎng)景 KL_FQ:考拉分期場(chǎng)景 |
| encrypted_field | 加密域 | C | String(516) | 加密域信息(json字符串格式),不同的訂單場(chǎng)景類型需要上送的結(jié)構(gòu)不一樣(詳見(jiàn)具體場(chǎng)景) |
| scene_info | 訂單場(chǎng)景信息 | C | String(1024) | 訂單場(chǎng)景信息(json字符串格式),不同的訂單場(chǎng)景類型需要上送的結(jié)構(gòu)不一樣(詳見(jiàn)具體場(chǎng)景) |
ONLINE_WILDCARD場(chǎng)景
encrypted_field字段說(shuō)明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說(shuō)明 |
|---|---|---|---|---|
| billingAddress | 賬單地址 | C | String | 賬單地址(json字符串結(jié)構(gòu)體) |
| –> houseNumberOrName | 門(mén)牌號(hào)或姓名 | M | String | 賬單地址 - 門(mén)牌號(hào)或姓名 |
| –> street | 街道 | M | String | 賬單地址 - 街道 |
| –> city | 城市 | M | String | 賬單地址 - 城市 |
| –> country | 國(guó)家 | M | String | 賬單地址 - 國(guó)家 |
| –> street | 街道 | M | String | 賬單地址 - 街道 |
| –> stateOrProvince | 州或省 | C | String | 賬單地址 - 州或省 |
| –> postalCode | 郵編 | M | String | 賬單地址 - 郵編 |
| mobilePhone | 注冊(cè)手機(jī)號(hào) | C | String | 用戶注冊(cè)手機(jī)號(hào) |
| 注冊(cè)郵箱 | C | String | 注冊(cè)郵箱 | |
| recipientFirstName | 收件人名 | M | String | 收件人名 |
| recipientLastName | 收件人姓 | M | String | 收件人姓 |
scene_info字段說(shuō)明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說(shuō)明 |
|---|---|---|---|---|
| userId | 用戶id | M | String | 用戶id |
| userCreateDate | 用戶創(chuàng)建時(shí)間 | M | String | 消費(fèi)者在商戶網(wǎng)站創(chuàng)建賬號(hào)的日期 (yyyyMMddHHmmss) |
| recipientStreet | 收件人街道 | M | String | 收件人街道 |
| recipientCity | 收件人城市 | M | String | 收件人城市 |
| recipientStateOrProvince | 收件人州 省 | M | String | 收件人州 省 |
| recipientCountry | 收件人國(guó)家 | M | String | 收件人國(guó)家 |
trans_currency字段說(shuō)明
| 幣種名稱 | 數(shù)字代碼 |
|---|---|
| 人民幣 | 156 |
| 美元 | 840 |
| 英鎊 | 826 |
| 歐元 | 978 |
| 日元 | 392 |
| 加元 | 124 |
| 澳元 | 036 |
| 韓元 | 410 |
| 港元 | 344 |
KL_FQ場(chǎng)景
encrypted_field字段說(shuō)明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說(shuō)明 |
|---|---|---|---|---|
| UNFQ | 銀聯(lián)聚分期 | C | String | json字符串結(jié)構(gòu)體 |
| –> cardNo | 卡號(hào) | C | String | 卡號(hào) |
| –> bankNm | 銀行簡(jiǎn)稱 | C | String | 銀行簡(jiǎn)稱 |
| HBINCREASE | 花唄提額(僅供花唄時(shí)使用,即order_scene_type為KL_FQ時(shí)的花唄場(chǎng)景,或者直接是HB_FQ) | C | String | json字符串結(jié)構(gòu)體 |
| –> identityNo | 身份證 | C | String | 身份證 |
| –> name | 姓名 | C | String | 姓名 |
| –> projectName | 項(xiàng)目名稱 | C | String | 項(xiàng)目名稱 |
| –> fqOption | 分期選項(xiàng)(用戶付息-user,商戶貼息-merchant) | C | String | 分期選項(xiàng)(用戶付息-user,商戶貼息-merchant) |
| –> fqNum | 分期期數(shù)(僅支持3、6、12) | C | String | 分期期數(shù) |
| –> secondaryMerchantId | 支付寶子商戶號(hào) | C | String | 支付寶子商戶號(hào) |
scene_info字段說(shuō)明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說(shuō)明 |
|---|---|---|---|---|
| UNFQ | 銀聯(lián)聚分期 | C | String | json字符串結(jié)構(gòu)體 |
| –> isForce | 是否強(qiáng)制 | C | String | 01:強(qiáng)制 |
| –> unFqNum | 分期期數(shù) | C | String | |
| –> unFqSellerPercent | 分期費(fèi)率 | C | String | |
| HBFQ | 花唄分期 | C | String | json字符串結(jié)構(gòu)體 |
| –> hbFqNum | 分期期數(shù) | C | String | |
| –> hbFqSellerPercent | 分期費(fèi)率 | C | String |
考拉分期order_scene_field送值樣例
{
"order_scene_field":
{
"encrypted_field": "{\"UNFQ\":\"{\\\"cardNo\\\":\\\"623622656535665656\\\",\\\"bankNm\\\":\\\"招商銀行\(zhòng)\\"}\"}",
"order_scene_type": "KL_FQ",
"scene_info": "{\"UNFQ\":\"{\\\"isForce\\\":\\\"01\\\",\\\"unFqNum\\\":\\\"6\\\",\\\"unFqSellerPercent\\\":\\\"0\\\"}\",\"HBFQ\":\"{\\\"hbFqNum\\\":\\\"3\\\",\\\"hbFqSellerPercent\\\":\\\"0\\\"}\"}"
}
}復(fù)制請(qǐng)求樣例:
{
"req_data": {
"out_order_no": "KFPT20220714160009228907288",
"merchant_no": "8222900701106PZ",
"vpos_id": "587305941625155584",
"channel_id": "2021052614391",
"total_amount": "1",
"order_efficient_time": "20220714170009",
"notify_url": "http://run.mocky.io/v3/b02c9448-20a2-4ff6-a678-38ecab30161d",
"support_cancel": "0",
"support_refund": "1",
"support_repeat_pay": "1",
"busi_type_param": "[{\"busi_type\":\"UPCARD\",\"params\":{\"crd_flg\":\"CRDFLG_D|CRDFLG_C|CRDFLG_OTH\"}},{\"busi_type\":\"SCPAY\",\"params\":{\"pay_mode\":\"WECHAT\",\"crd_flg\":\"CRDFLG_D\"}}]",
"counter_param": "{\"pay_mode\":\"ALIPAY\"}",
"out_user_id": "",
"order_info": "自動(dòng)化測(cè)試",
"extend_info": "自動(dòng)化測(cè)試",
"transfer_field": {
"acc_out_no": "62266211223334323",
"acc_out_name": "張三",
"additional": "轉(zhuǎn)賬附言"
},
"callback_url": "",
"product_id": "200809",
"goods_mark": "1",
"goods_field": "{\"goods_amt\":1,\"goods_name\":\"卅\",\"goods_num\":1,\"goods_pricing_unit\":\"1\",\"goods_type\":\"11\",\"te_platform_name\":\"amazon\",\"te_platform_type\":\"2\"}",
"order_scene_field": {
"order_scene_type": "ONLINE_WILDCARD",
"encrypted_field": "{\"billingAddress\":\"{\\\"houseNumberOrName\\\":\\\"123 Main St\\\",\\\"street\\\":\\\"Main Street\\\",\\\"city\\\":\\\"New York\\\",\\\"country\\\":\\\"USA\\\",\\\"stateOrProvince\\\":\\\"BT\\\",\\\"postalCode\\\":\\\"10001\\\"}\",\"mobilePhone\":\"+86 13531231231\",\"recipientFirstName\":\"王\",\"recipientLastName\":\"五\"}",
"scene_info": "{\"userId\":\"12312312\",\"userCreateDate\":\"20230402121212\",\"recipientStreet\":\"Main Street\",\"recipientCity\":\"New York\",\"recipientStateOrProvince\":\"BT\",\"recipientCountry\":\"USA\"}"
}
},
"version": "3.0",
"req_time": "20220714160009"
}復(fù)制返回參數(shù)
| 字段名 | 是否必輸 | 類型 | 長(zhǎng)度 | 字段描述 | 示例 |
|---|---|---|---|---|---|
| merchant_no | M | String | 32 | 結(jié)算商戶號(hào) | |
| channel_id | M | String | 32 | ||
| out_order_no | M | String | 32 | 商戶訂單號(hào) | |
| order_create_time | M | String | 32 | 創(chuàng)建訂單時(shí)間 | 訂單系統(tǒng)創(chuàng)建訂單的時(shí)間,格式y(tǒng)yyyMMddHHmmss |
| order_efficient_time | M | String | 32 | 訂單有效截至?xí)r間 | 格式y(tǒng)yyyMMddHHmmss |
| pay_order_no | M | String | 64 | 平臺(tái)訂單號(hào) | 21070211012001970631000383039 |
| total_amount | M | long | 12 | 訂單金額,單位:分 | 200 |
| counter_url | M | String | 256 | 收銀臺(tái)地址信息 |
響應(yīng)樣例:
{
"msg": "操作成功",
"resp_time": "20210922181057",
"code": "000000",
"resp_data": {
"merchant_no": "8222900701106PZ",
"channel_id": "25",
"out_order_no": "KFPT20220714160009228907288",
"order_create_time": "20210922181056",
"order_efficient_time": "20210803141700",
"pay_order_no": "21092211012001970631000488056",
"counter_url": "http://q.huijingcai.top/b/pay?merchantNo=8221210594300JY&merchantOrderNo=08F4542EEC6A4497BC419161747A92FQ&payOrderNo=21092211012001970631000488056"
}
}復(fù)制返回碼code一覽表
| msg | code |
|---|---|
| 成功 | 000000 |
The End
