聚合收銀臺訂單創(chuàng)建參數(shù)

拉卡拉2.0 5個月前 ( 11-20 ) 273

調(diào)用地址

注：因銀網(wǎng)聯(lián)測試環(huán)境問題，微信錢包在測試環(huán)境下無法下單完成支付，下單后提示”sub mch id與sub appid不匹配”報錯即可。

自2024年1月16日起，請通過以下接口進行接入：

使用HTTP協(xié)議，POST方式提交。

URL(測試環(huán)境外網(wǎng))：https://test.wsmsd.cn/sit/api/v3/ccss/counter/order/special_create

URL(生產(chǎn)環(huán)境)：https://s2.lakala.com/api/v3/ccss/counter/order/special_create

商戶需在微信商家后臺配置以下支付域名（原支付目錄），2023 年 9 月后入網(wǎng)的商戶可忽略此配置：

生產(chǎn)環(huán)境訂單域名：pay.lakala.com

測試環(huán)境訂單域名：pay.wsmsd.cn

請求參數(shù)

字段名是否必輸類型長度字段描述示例
out_order_noMString32商戶訂單號12345678
merchant_noMString32銀聯(lián)商戶號822100041120005
vpos_idCString32交易設(shè)備標識，進件返回接口中的termId字段，非API接口進件請聯(lián)系業(yè)務(wù)員。462621830268882944
channel_idCString32渠道號 （一般不用）24865454154
total_amountMlong12訂單金額，單位：分200
order_efficient_timeMString14訂單有效期 格式y(tǒng)yyyMMddHHmmss,最大支持下單時間+7天20210803141700
notify_urlCString128訂單支付成功后商戶接收訂單通知的地址 http://xxx.xxx.com
support_cancelCint1是否支持撤銷 默認 0 不支持
busi_mode為“PAY-付款”不支持 撤銷		（0 不支持 1支持）
support_refundCint1是否支持退款 默認0 不支持（0 不支持 1支持）
support_repeat_payCint1是否支持“多次發(fā)起支付” 默認0 不支持（0 不支持 1支持）
out_user_idCString64發(fā)起訂單方的userId，歸屬于channelId下的userId
callback_urlCString128客戶端下單完成支付后返回的商戶網(wǎng)頁跳轉(zhuǎn)地址。
order_infoMString64訂單標題，在使用收銀臺掃碼支付時必輸入，交易時送往賬戶端
term_noCString32結(jié)算終端號,合單場景必輸該字段
split_markCString2合單標識，“1”為合單，不填默認是為非合單
settle_typeCString4

結(jié)算類型（非合單） （“0”或者空，常規(guī)結(jié)算方式）
  注意：該字段會影響結(jié)算方式，慎用。（調(diào)用拉卡拉分賬接口，分賬模式為標記分賬時需必傳1）


out_split_infoCList<>
拆單信息
合單標識為“1”時必傳該字段。,詳細字段見out_split_info字段說明
counter_paramCString1024json字符串 收銀臺展示參數(shù){\“pay_mode\“ : \“ALIPAY\“} ，指定支付方式為支付寶
ALIPAY：支付寶
WECHAT：微信
UNION：銀聯(lián)云閃付
CARD：POS刷卡交易
LKLAT：線上轉(zhuǎn)帳
QUICK_PAY：快捷支付
EBANK：網(wǎng)銀支付
UNION_CC：銀聯(lián)支付

BESTPAY：翼支付
HB_FQ：花唄分期
UNION_FQ：銀聯(lián)聚分期

ONLINE_CARDLESS：線上外卡

JDBT:京東白條

ALIPAY_HK:支付寶香港錢包支付

若要指定支付方式為支付寶傳參格式：
{\“pay_mode\“ : \“ALIPAY\“}

counter_remark
CString128收銀臺備注
busi_type_paramCString256業(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\“}}]
說明：UPCARD-刷卡，SCPAY-掃碼，CRDFLG_D-借記卡，CRDFLG_C-貸記卡，CRDFLG_OTH-不明確是借記卡還是貸記卡
pay_mode送參說明：ALIPAY-支付寶，WECHAT-微信，UNION-銀聯(lián)二維碼，DCPAY-數(shù)字貨幣，BESTPAY-翼支付

說明：一旦使用該字段，則增加限制，必須在指定限制范圍內(nèi)支付。比如，只配置”busi_type”:”UPCARD”的參數(shù)而不配置”busi_type”:”SCPAY”的參數(shù)，則只能通過刷卡而不能通過掃碼完成支付

sgn_infoClist<>
簽約協(xié)議號列表（字符串）[“1234”,”2345”]，不支持空列表[]；列表中簽約協(xié)議號不能為空；列表中簽約協(xié)議號不能重復
product_id
CString6指定產(chǎn)品編號 （200809:線上外卡收銀臺） 注意：該字段默認不需要指定，特殊場景下使用，慎用
goods_markCString
商品信息標識 （1:含商品信息，不填默認不含商品信息）
goods_fieldCString2商品信息域(good_mark送1時該域必填，否則不送。只有線上外卡業(yè)務(wù)上送該字段) 詳細字段見goods_field字段說明
order_scene_fieldCObject
2訂單場景域，特殊場景下需要上送 詳細字段見order_scene_field字段說明
age_limitCString10:不限年齡；1:年齡限制
repeat_pay_auto_refundCString1

0:重復支付后不自動退貨；1:重復支付后自動退貨 （默認不送為0），注意：請詳細了解字段場景后上送

需注意互斥條件：repeat_pay_auto_refund選擇“1”重復支付后自動退貨后，repeat_pay_notify僅支持選擇“0”重復支付訂單不通知


repeat_pay_notifyCString10:重復支付訂單不通知；1:重復支付訂單通知 （默認不送為0）
close_order_auto_refundCString10:不自動退貨；1:關(guān)閉訂單后支付成功觸發(fā)自動退貨 （默認不送為0）注意：請詳細了解字段場景后上送
shop_nameCString64網(wǎng)點名稱
inte_routingCString2智能路由下單標識 1-是 0-否（默認不送為0）備注：需要在收銀臺管控臺配置聚合收銀臺小程序白名單
discount_codeCString64優(yōu)惠碼(目前供線上國補下單使用)
electrical_equipment_categoryC
String
128支付寶優(yōu)惠碼(目前優(yōu)惠碼的地區(qū)：浙江、江蘇、上海、福建、重慶)
trade_biz_tpCString16線上業(yè)務(wù)通道類型具體類型見補充枚舉


out_split_info字段說明

字段名中文名稱是否必填類型說明
out_sub_order_no外部子訂單號MString(32)商戶子訂單號
merchant_no商戶號MString(32)拉卡拉分配的銀聯(lián)商戶號
term_no終端號MString(32)拉卡拉分配的業(yè)務(wù)終端號
amount金額MString(12)單位分，整數(shù)型字符
settle_type結(jié)算類型（合單）CString(4)“0”或者空，常規(guī)結(jié)算方式

說明：

 1）拆單信息域中商戶號不可重復；

 2）交易層訂單金額必須是拆單信息域中各個子單的金額匯總之和；

 3）對拆單信息域中每個結(jié)算商戶號和終端號的權(quán)限交易都必須通過，其中一個校驗失敗，則交易中止，失敗返回；

 4）拆單域中子單條數(shù)最少兩條、最多20條，否則拒絕。

goods_field字段說明

字段名中文名稱是否必填類型說明
goods_amt商品單價MLong單位：分
goods_num商品數(shù)量MInteger
goods_pricing_unit商品計價單位MString(8)1-箱 2-件 3-瓶 4-個
goods_name商品名稱MString(128)
te_platform_type交易電商平臺類型MString(2)1-境內(nèi)平臺 2-境外平臺
te_platform_name交易電商平臺名稱MString(256)
goods_type交易商品類型MString(8)1:服飾箱包
2:食品藥品
3:化妝品
4:電子產(chǎn)品
5:日用家居
7:航空機票
8:酒店住宿
9:留學教育
10:旅游票務(wù)
11:國際物流
12:國際租車
13:國際會議
14:軟件服務(wù)
15:醫(yī)療服務(wù)
16:通訊
17:休閑娛樂

order_scene_field字段說明

字段名中文名稱是否必填類型說明
order_scene_type訂單場景類型MString(16)訂單場景類型（按下述定義場景送值）

HB_FQ：花唄分期場景

KL_FQ：考拉分期場景

scene_info訂單場景信息CString(1024)訂單場景信息（json字符串格式），不同的訂單場景類型需要上送的結(jié)構(gòu)不一樣（詳見具體場景）

HB_FQ場景

scene_info字段說明

字段名中文名稱是否必填類型說明
hbFqNum花唄分期期數(shù)MString支付寶花唄分期必送字段: 花唄分期數(shù) 3：3期 6：6期 12：12期
hbFqSellerPercent賣家承擔手續(xù)費比例MString支付寶花唄分期必送字段: 賣家承擔手續(xù)費比例，間連模式下只支持傳0。

JDBT場景

scene_info字段說明

字段名中文名稱是否必填類型說明
LOCKPLAN

String
->jdbtFqNum京東白條分期期數(shù)MString京東白條分期數(shù) 3：3期，6：6期，12：12期 ，24：24期

trade_biz_tp字段說明

拉卡拉業(yè)務(wù)種類編碼編碼含義
100001虛擬商品購買
100002預付費類賬戶充值
100003實物消費
100004航空商旅消費
100005生活及商業(yè)服務(wù)消費
100006其他商戶消費
100007招投標保證金支付
100008境外商品購買
100A01實物商品租賃
100A03單用途預付卡充值
100A06商業(yè)服務(wù)消費
100A05航旅交通服務(wù)
100A07生活服務(wù)消費
100A08個人經(jīng)營服務(wù)
110001公共事業(yè)繳費
110002教育醫(yī)療繳費
110003政府服務(wù)繳費
110004公益捐款
110005農(nóng)林牧副漁收購
110006政府服務(wù)
110007薪資發(fā)放
110008其他公共服務(wù)
110A01水電煤氣繳費
110A02稅費繳納
110A03非營利性教育繳費
110A05罰款繳納
110A06路橋通行繳費
110A07郵政繳費
110A08電視賬單繳費
110A09話費賬單繳費
110A10寬帶賬單繳費
110A13財政非稅收入
110A14營利性教育培訓
110A15公共交通
110A16急救救援
110A17物業(yè)繳費
110A18國庫經(jīng)收
110A19供暖費繳納
110A20廢棄物處理費用繳納
110A21租金繳納
110A22會員費用繳納
110A23稅費退還
120001其他金融付款
120002其他金融收款
120003基金購買
120004保險選購
120005投資理財
120006信貸償還
120007信用卡還款轉(zhuǎn)出
120008基金贖回/返還/分紅
120009保險理賠/分紅
120010投資理財贖回/返還/分紅
120011信貸發(fā)放
120012信用卡還款轉(zhuǎn)入
120A01基金理財產(chǎn)品申購
120A02基金理財產(chǎn)品認購
120A03非投資型保險費用繳納
120A05商業(yè)眾籌
120A06貴金屬投資買入
120A07基金理財產(chǎn)品贖回
120A08基金理財產(chǎn)品到期返還
120A09認/申購失敗返還
120A10基金理財產(chǎn)品分紅
120A11保險理賠或退費
120A12保險紅利發(fā)放或給付發(fā)放
120A13貴金屬投資買出
120A16融資租賃
120A19投資型保險費用繳納
120A20小貸公司貸款還款
120A21保單貸款發(fā)放
120A22其他保險資金代發(fā)
130001支付賬戶充值
130002支付賬戶回提
130003銀行賬戶轉(zhuǎn)賬轉(zhuǎn)出
130004其他賬戶充值
130005銀行賬戶轉(zhuǎn)賬轉(zhuǎn)入
130006其他賬戶回提
130A03向他人支付賬戶轉(zhuǎn)賬
130A05預付卡贖回 -個人贖回
130A06預付卡贖回-單位贖回
130A08測試驗證資金
130A09薪酬福利發(fā)放
130A10代發(fā)貨款
140001商戶結(jié)算-交易資金結(jié)算
140002營銷返現(xiàn)
140003其他商戶結(jié)算
140A02預付卡商戶結(jié)算
140A03商戶收單資金提現(xiàn)
150A01資金歸集
200000對公業(yè)務(wù)



請求樣例

{
    "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": "自動化測試", 
        "extend_info": "自動化測試", 
        "callback_url": ""
    }, 
    "version": "3.0", 
    "req_time": "20220714160009"}
復制

返回參數(shù)

字段名是否必輸類型長度字段描述示例
merchant_noMString32
銀聯(lián)商戶號
channel_idMString32

out_order_noMString32商戶訂單號
order_create_timeMString32創(chuàng)建訂單時間訂單系統(tǒng)創(chuàng)建訂單的時間，格式y(tǒng)yyyMMddHHmmss
order_efficient_timeMString32訂單有效截至時間格式y(tǒng)yyyMMddHHmmss
pay_order_noMString64平臺訂單號21070211012001970631000383039
total_amountMlong12訂單金額，單位：分200
counter_urlMString256收銀臺地址信息

響應(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"
    }
}
復制

返回碼code一覽表

msgcode
成功000000


The End

標簽：博主很懶，并沒有設(shè)置標簽