拉卡拉聚合主掃接口說明-調(diào)用地址-請求報文

lakala 5個月前 ( 11-13 ) 666

聚合主掃

更新時間：2025-09-10 10:10:49

作者：wangyuwei

接口說明

1、商戶下單后獲取支付參數(shù)，調(diào)起支付，支持支付寶，微信，云閃付等支付方式；

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

調(diào)用地址

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

測試環(huán)境：https://test.wsmsd.cn/sit/api/v3/labs/trans/preorder

生產(chǎn)環(huán)境：https://s2.lakala.com/api/v3/labs/trans/preorder

請求報文

字段名中文名稱是否必填類型說明
merchant_no商戶號MString(32)拉卡拉分配的商戶號
term_no終端號MString(32)拉卡拉分配的業(yè)務(wù)終端號
out_trade_no商戶交易流水號MString(32)商戶系統(tǒng)唯一，對應(yīng)數(shù)據(jù)庫表中外部請求流水號。
account_type錢包類型MString(32)微信：WECHAT 支付寶：ALIPAY 銀聯(lián)：UQRCODEPAY 翼支付: BESTPAY 蘇寧易付寶: SUNING 拉卡拉支付賬戶：LKLACC 網(wǎng)聯(lián)小錢包：NUCSPAY 京東錢包：JD
trans_type接入方式MString(2)41:NATIVE（（ALIPAY，云閃付支持，京東白條分期）
51:JSAPI（微信公眾號支付，支付寶服務(wù)窗支付，銀聯(lián)JS支付，翼支付JS支付, 拉卡拉錢包支付, 京東白條分期）

71:微信小程序支付

61:APP支付（微信APP支付）

total_amount金額MString(12)單位分，整數(shù)型字符
location_info地址位置信息MObject地址位置信息，風(fēng)控要求必送
busi_mode業(yè)務(wù)模式CString(8)業(yè)務(wù)模式： ACQ-收單 不填，默認為“ACQ-收單”
subject訂單標題CString(42)標題，用于簡單描述訂單或商品主題，會傳遞給賬戶端 （賬戶端控制，實際最多42個字符），微信支付必送。
pay_order_no支付業(yè)務(wù)訂單號CString(64)拉卡拉訂單系統(tǒng)訂單號，以拉卡拉支付業(yè)務(wù)訂單號為驅(qū)動的支付行為，需上傳該字段。
notify_url商戶通知地址CString(128)商戶通知地址，如果上傳，且 pay_order_no 不存在情況下，則按此地址通知商戶(詳見“[交易通知]”接口)
settle_type結(jié)算類型CString(4)“0”或者空，常規(guī)結(jié)算方式，如需接拉卡拉分賬通需傳“1”，商戶未開通分賬之前切記不用上送此參數(shù)。
remark備注CString(128)
acc_busi_fields賬戶端業(yè)務(wù)信息域CObject參見以下acc_busi_fields字段詳細說明,不同的account_type和trans_type，需要傳入的參數(shù)不一樣
complete_notify_url發(fā)貨確認通知地址CString(128)發(fā)貨類小程序確認收獲后通知商戶的地址

location_info字段說明

字段名中文名稱是否必填類型說明
request_ip請求方IP地址MString(64)請求方的IP地址，存在必填，格式如36.45.36.95
base_station基站信息CString(128)客戶端設(shè)備的基站信息（主掃時基站信息使用該字段）
location緯度,經(jīng)度CString(32)

商戶終端的地理位置，銀聯(lián)二維碼交易必填，整體格式：緯度,經(jīng)度，+表示北緯、東經(jīng)，-表示南緯、 西經(jīng)。

經(jīng)度格式：1位正負號+3位整數(shù)+1位小數(shù)點+5位小數(shù)；

緯度格式：1位正負號+2位整數(shù)+1位小數(shù)點+6位小數(shù)；

舉例：+31.221345,+121.12345

支付寶主掃場景下acc_busi_fields域內(nèi)容

字段名中文名稱是否必填類型說明
user_id買家在支付寶的用戶idCString(64)支付寶的buyer_user_id ,trans_type為41-NATIVE情況下不需要傳，為51情況下必須傳入
timeout_express預(yù)下單有效時間CString(2)預(yù)下單的訂單的有效時間，以分鐘為單位。如果在有效時間內(nèi)沒有完成付款，則在賬戶端該訂單失效。如果不上送，以賬戶端訂單失效時間為準。 建議不超過15分鐘。不傳值則默認5分鐘。
extend_params業(yè)務(wù)擴展參數(shù)CObject支付寶業(yè)務(wù)擴展參數(shù) ，見說明
goods_detail商品詳情CString(6000)訂單包含的商品列表信息，Json數(shù)組。
store_id商戶門店編號CString(32)支付寶收單上送
alipay_store_id(不再使用)支付寶店鋪編號CString(32)支付寶已不再使用該字段
disable_pay_channels支付寶禁用支付渠道CString(32)

“credit_group”表示禁用信用支付類（包含信用卡,花唄，花唄分期）

“pcredit”表示禁用花唄

“pcreditpayInstallment”表示禁用花唄分期

“creditCard“表示禁用信用卡

如果想禁用多個可在枚舉間加,隔開

business_params商戶傳入業(yè)務(wù)信息CString(512)商戶傳入業(yè)務(wù)信息，應(yīng)用于安全，營銷等參數(shù)直傳場景，格式為 json 格式。
示例：{“enable_thirdpar ty_subsidy”:”N”,”source”:”xxxx”},source送值與吱口令生成接口中上送的source對應(yīng)，值內(nèi)容為“inderict_wx_吱口令申領(lǐng)接口中source值”
min_age允許的最小買家年齡CString(2)買家年齡必須大于等于所傳數(shù)值
promo_params優(yōu)惠明細Cobject優(yōu)惠明細參數(shù)，通過此屬性補充營銷參數(shù)
priority_pay_assets優(yōu)先使用資產(chǎn)Cobject優(yōu)先使用資產(chǎn)
enable_pay_channels支付通道CString(128)

支付通道:如「因公付」+「招商銀行借記卡」:enterprisePay,debit group#CMB 如「因公付」+

「招商銀行貸記卡」:enterprisePay.credit_group#CMB

支付寶extend_params字段說明

字段名中文名稱是否必填類型說明
sys_service_provider_id服務(wù)商的PIDCString(64)系統(tǒng)商編號，該參數(shù)作為系統(tǒng)商返傭數(shù)據(jù)提取的依據(jù)，請?zhí)顚懴到y(tǒng)商簽約協(xié)議的 PID
hb_fq_num花唄分期期數(shù)MString(5)支付寶花唄分期必送字段: 花唄分期數(shù) 3：3期 6：6期 12：12期
hb_fq_seller_percent賣家承擔手續(xù)費比例MString(3)支付寶花唄分期必送字段: 賣家承擔收費比例，間連模式下只支持傳0。
food_order_type點餐場景類型CString點餐場景類型：qr_order（店內(nèi)掃碼點餐），pre_order（預(yù)點到店自提），home_delivery （外送到家），direct_payment（直接付款），other（其它）
electrical_promo_extends核銷數(shù)據(jù)信息上報字段CString(512)?付成功后，?付寶將在T+1?將相應(yīng)的核銷數(shù)據(jù)上送資格核驗平臺
“{"addCode":"xxxxxxxxxxx","address":"xxxxxxxxx","brand":"xxxxxxxxx","countryGoodsCode":"xxxxxxxxx"}”
fq_num信用卡分期期數(shù)CString(2)根據(jù)實際選擇期數(shù)上送，僅支持傳入 3、6、12
fq_seller_percent信用卡分期手續(xù)費比例CString(12)支付寶信用卡分期必送字段: 賣家承擔收費比例，間連模式下只支持傳0。
fq_channels信用卡分期優(yōu)先使用資產(chǎn)類型CString(20)信用卡分期必送該字段，暫時僅?持傳?alipayfq_cc
pd_sub_biz_scene支付默認場景c
String(128)固定資產(chǎn): enterprisePay

支付寶goods_detail字段說明

字段名中文名稱是否必填類型說明
goods_id
MString(32)商品的編號
alipay_goods_id
CString(32)支付寶定義的統(tǒng)一商品編號
goods_name
MString(256)商品名稱
quantity
MNumber商品數(shù)量
price
MPrice商品價格 單位元
goods_category
CString(24)商品類目
categories_tree
CString(128)商品類目樹，從商品類目根節(jié)點到葉子節(jié)點的類目 id 組成，類目 id 值使用|分 割
body
CString(512)商品描述信息
show_url
CString(256)商品的展示地址

支付寶promo_params字段說明

字段名中文名稱是否必填類型說明
electrical_equipment_category國補優(yōu)惠碼CString(128)國補優(yōu)惠碼

支付寶priority_pay_assets字段說明

字段名中文名稱是否必填類型說明
assets_list資產(chǎn)列表Clist資產(chǎn)列表
–asset_name資產(chǎn)名稱CString

花唄資產(chǎn)，如：pcredit

固定資產(chǎn): enterprisePay

支付寶business_params字段說明（JSON格式）

{"assignJointAccountld":"15567","enterprisePayAmount":"15567","identityPayBizlnfo":"15567","enterprise_pay_info":"15567"}

字段名中文名稱是否必填類型說明
assignJointAccountld指定的因公付賬戶CString如果存在指定，僅會使用對應(yīng)的資產(chǎn)進行支付（此賬號為指定的付款賬號，需要設(shè)置可用的支付資產(chǎn)
enterprisePayAmount指定因公付出資金額CString
identityPayBizlnfo因公付業(yè)務(wù)字段CString
enterprise_pay_info加簽字段CString方案加簽字段，如對接刷卡極付方案，本字段必選，如對接劇臉極付方案，本字段可忽略

微信主掃場景下acc_busi_fields域內(nèi)容

字段名中文名稱是否必填類型說明
timeout_express預(yù)下單有效時間CString(2)預(yù)下單的訂單的有效時間，以分鐘為單位。建議不超過15分鐘。不傳值則默認5分鐘。(微信主掃下單上送的失效時間，是控制prepay_id調(diào)起支付的有效時間。微信后臺不會根據(jù)失效時間發(fā)起關(guān)單。 如需關(guān)單，調(diào)用關(guān)單接口。)
sub_appid子商戶公眾賬號IDCString(32)微信分配的子商戶公眾賬號ID，sub_appid（即微信小程序支付-71、公眾號支付-51、微信app支付-61），此參數(shù)必傳，只對微信支付有效 工行數(shù)字錢包情況下，該字段上送工行的openId 拉卡拉錢包情況下，該字段上送LAKALA的userId
user_id用戶標識CString(64)用戶在子商戶sub_appid下的唯一標識，sub_openid，（即微信小程序支付-71、眾號支付-51），此參數(shù)必傳，只對微信支付有效
detail商品詳情CString(1024)單品優(yōu)惠功能字段，詳見下文說明
goods_tag訂單優(yōu)惠標記CString(32)訂單優(yōu)惠標記，微信平臺配置的商品標記，用于優(yōu)惠券或者滿減使用，accountType為WECHAT時，可選填此字段
attach附加域CString(128)該字段主要用于商戶攜帶訂單的自定義數(shù)據(jù)。商戶定制字段，直接送到賬戶端。
device_info設(shè)備號CString(32)終端設(shè)備號(門店號或收銀設(shè)備ID)，注意：PC網(wǎng)頁或JSAPI支付請傳”WEB”
limit_pay指定支付方式CString(20)no_credit–指定不能使用信用卡支付
scene_info場景信息CString(256)該字段用于上報場景信息，目前支持上報實際門店信息。
limit_payer限定支付CString(8)ADULT：成年人

微信detail字段說明

字段名中文名稱是否必填類型說明
cost_price
CString(12)1.商戶側(cè)一張小票訂單可能被分多次支付，訂單原 價用于記錄整張小票的交易金額。 2.當訂單原價與支付金額不相等，則不享受優(yōu)惠。 3.該字段主要用于防止同一張小票分多次支付，以 享受多次優(yōu)惠的情況，正常支付訂單不必上傳此參 數(shù)。 如：608800
receipt_id
CString(12)商家小票 ID
goods_detail
MObject單品信息，使用Json數(shù)組格式提交，見示例
微信goods_detail字段說明
字段名中文名稱是否必填類型說明
goods_id
MString(32)由半角的大小寫字母、數(shù)字、中劃線、下劃線中的一種或幾種組成。如“商品編碼”
wxpay_goods_id
CString(32)微信支付定義的統(tǒng)一商品編號
goods_name
CString(256)商品的實際名稱
quantity
Mint用戶購買的數(shù)量
price
Mint單位為：分。如果商戶有優(yōu)惠，需傳輸商戶優(yōu)惠后的單價

銀聯(lián)云閃付主掃場景下acc_busi_fields域內(nèi)容

字段名中文名稱是否必填類型說明
user_id用戶idCString(64)JS獲取用戶標識返回碼不為34時，必送（詳情請參考用戶標識查詢接口）
timeout_express預(yù)下單有效時間CString(2)預(yù)下單的訂單的有效時間，以分鐘為單位。如果在有效時間內(nèi)沒有完成付款，則在賬戶端該訂單失效。如果不上送，以賬戶端訂單失效時間為準。 建議不超過15分鐘。不傳值則默認5分鐘。
acq_addn_data_order_info銀聯(lián)訂單信息CString(600)銀聯(lián)單品營銷訂單信息 ： “acq_addn_data_order_info”:”{"title":"","dctAmount":"","addnInfo":{ "preproduct":"bt","lockplan":"3","riskInfo":{"agentSubMerchantNo":"660080656512571","itemNo":"500100018","orderSource":"微信APP掃一掃","payUserId":"oLvoQ5eGT5AvIQ62zZ5IDFqxeimg","payCodeId":"223101000221675242"}}}”
acq_addn_data_goods_info銀聯(lián)商品信息CString(6000)銀聯(lián)單品營銷商品信息 ： “acq_addn_data_goods_info”:”[{"id":"6927044525471","name":"商品1","price":"10","quantity":"1"}]”
front_url銀聯(lián)前臺通知地址CString(256)收款方向銀聯(lián)推送訂單時上送的前臺通知地址（僅允許為外網(wǎng)地址），用戶完成支付點擊，“返回”后，銀聯(lián)通過瀏覽器POST請求到該地址。 當transType為JSAPI，payMode為UQRCODEPAY時，可選填此字段
front_fail_url銀聯(lián)失敗交易前臺通知地址CString(256)收款方向銀聯(lián)推送訂單時上送的失敗交易前臺通知地址（僅允許為外網(wǎng)地址），用戶支付過程中交易失敗，點擊“返回”后，銀聯(lián)通過瀏覽器GET請求到該地址。 當transType為JSAPI，payMode為UQRCODEPAY時，可選填此字段，需與frontUrl同時出現(xiàn)，未上送默認為frontUrl的值
instal_will分期意愿CString(1)0: 不分期（缺省） 1：分期
un_qrcode銀聯(lián)二維碼qrcodeCString(1000)標識交易信息
user_auth_code銀聯(lián)二維碼authCodeCString(256)用戶信息的臨時授權(quán)碼
jd_addition_infoJD附加信息CObject{"stagesFee":"25"}
app_up_identifier銀聯(lián)支付標識CString(32)MicroMessenger
pay_channel支付渠道CString(10)云閃付微信渠道交易出現(xiàn)01：云閃付微信小程序02：云閃付微信公眾號
third_part_app_id第三方appidCString(256)機構(gòu)、渠道商、商戶在第三方注冊的公眾賬號ID。上送支付渠道標識時且取值為01或02時，出現(xiàn)JSON 格式. "third_part_app_id": {"thirdAppId":"商家的appid"}
third_part_open_id第三方openidCString(256)機構(gòu)、渠道商、商戶在第三方注冊的openid。上送支付渠道標識時且取值為01或02時，出現(xiàn)JSON 格式. "third_part_open_id": {"thirdOpenId":"商家appid下的openid"}

銀聯(lián)云閃acq_addn_data_order_info字段說明

字段名中文名稱是否必填類型說明
title
OString(32)
dctAmount
OString(32)
addnInfo
OObject京東白條分期必傳

銀聯(lián)云閃addn_info字段說明

字段名中文名稱是否必填類型說明
preproduct白條前置標識MString(32)白條前置標識，用于識別收銀臺側(cè)僅展示白條支付工具(固定上送bt)
lockplan期數(shù)3/6/12CString(16)預(yù)鎖分期活動，用于收銀臺側(cè)展示對應(yīng)的分期活動信息（不填則白條收銀臺頁面不固定對應(yīng)期數(shù)）
riskInfo
MObject白條側(cè)策略采集字段信息

銀聯(lián)云閃risk_info說明

字段名中文名稱是否必填類型說明
itemNo項目編號CString(16)由白條側(cè)前置預(yù)先分配的項目編號
orderSource下單來源MString(32)消費者下單來源，傳中文，枚舉如下：微信APP掃一掃、京東金融、京東（目前僅支持微信APP掃一掃）
payUserId用戶IDCString(32)當orderSource為微信app掃一掃時上送openid
payCodeId商戶收款碼IDMString(32)商戶收款碼ID，可以是商家展業(yè)所應(yīng)用的靜態(tài)碼/動態(tài)碼所發(fā)生的終端設(shè)備唯一識別序列號
merchantType商戶類型CString(32)商戶類型，傳中文，枚舉如下:企業(yè)、個體戶、自然人;若是個人商戶，自然人必傳
tradeScene場景CString(8)固定值：線上：01，線下：02
orderEid下單設(shè)備CString(64)下單設(shè)備號，需是設(shè)備在商戶側(cè)唯一標識
orderIp下單ipCString(64)下單ip
orderAccount下單賬號CString(32)下單賬號，用戶在商戶側(cè)唯一標識
acctRegTime下單賬號注冊時間CString(32)yyyy-mm-dd hh:mm:ss

銀聯(lián)云閃acq_addn_data_goods_info說明

字段名中文名稱是否必填類型說明
id商品編號MString(32)
name商品名稱MString(64)
price商品單價MString(10)
quantity商品數(shù)量MString(16)
category商品類目OString(32)
addninfo附加信息OString(128)

網(wǎng)聯(lián)小錢包acc_busi_fields域內(nèi)容

字段名中文名稱是否必填類型說明
nuc_issr_id小錢包金融機構(gòu)編號CString(64)

響應(yīng)報文

字段名中文名稱是否必填類型說明
merchant_no商戶號MString(32)拉卡拉分配的商戶號（請求接口中商戶號）
out_trade_no商戶請求流水號MString(32)請求報文中的商戶請求流水號
trade_no拉卡拉交易流水號MString(32)拉卡拉交易流水號
log_no拉卡拉對賬單流水號MString(14)拉卡拉對賬單流水號
settle_merchant_no結(jié)算商戶號MString(32)拉卡拉分配的商戶號
settle_term_no結(jié)算終端號MString(32)拉卡拉分配的業(yè)務(wù)終端號
acc_resp_fields賬戶端返回信息域CObject賬戶端返回信息域

支付寶(41-NATIVE)場景下返回acc_resp_fields域

字段名中文名稱是否必填類型說明
code二維碼信息MString(256)商戶可用此參數(shù)自定義去生成二維碼后展示出來進行掃碼支付
code_image二維碼圖片內(nèi)容MString(256)商戶收款二維碼圖片。Base64編碼，暫無
sub_mch_id
子商戶號CString(20)賬戶端子商戶號

支付寶(51-JSAPI)場景下返回acc_resp_fields域

字段名中文名稱是否必填類型說明
prepay_id預(yù)下單IdMString(32)預(yù)支付交易會話ID
sub_mch_id子商戶號CString(20)賬戶端子商戶號

微信(71-小程序)微信(51-JSAPI)場景下返回acc_resp_fields域

字段名中文名稱是否必填類型說明
prepay_id預(yù)下單IdMString(32)預(yù)支付交易會話ID
pay_sign支付簽名信息MString(256)簽名
app_id小程序idMString(32)商戶注冊具有支付權(quán)限的小程序成功后即可獲得小程序id
time_stamp時間戳MString(32)當前的時間
nonce_str隨機字符串MString(32)隨機字符串
package訂單詳情擴展字符串MString(128)
sign_type簽名方式MString(32)簽名類型，支持RSA
sub_mch_id子商戶號CString(20)賬戶端子商戶號

銀聯(lián)二維碼(41-NATIVE)場景下返回acc_resp_fields域

字段名中文名稱是否必填類型說明
code二維碼信息MString(256)商戶可用此參數(shù)自定義去生成二維碼后展示出來進行掃碼支付

京東(41-NATIVE)場景下返回acc_resp_fields域

字段名中文名稱是否必填類型說明
code二維碼信息MString(256)商戶可用此參數(shù)自定義去生成二維碼后展示出來進行掃碼支付

銀聯(lián)二維碼(51-JSAPI)場景下返回acc_resp_fields域

字段名中文名稱是否必填類型說明
redirect_url銀聯(lián)JS支付重定向地址MString(256)銀聯(lián)JS支付返回重定向地址
sub_mch_id子商戶號CString(20)賬戶端子商戶號

翼支付(51-JSAPI)場景下返回acc_resp_fields域

字段名中文名稱是否必填類型說明
best_pay_info翼支付JS參數(shù)CString(512)翼支付JS參數(shù)(老網(wǎng)聯(lián)) best_pay_info、redirect_url兩者有其一
redirect_url翼支付支付重定向地址CString(256)翼支付支付重定向地址(新網(wǎng)聯(lián))

微信(61-APP)場景下返回acc_resp_fields域

字段名中文名稱是否必填類型說明
prepay_id預(yù)下單IdMString(32)預(yù)支付交易會話ID
pay_sign支付簽名信息MString(256)簽名
app_id移動應(yīng)用appidMString(32)商戶注冊具有支付權(quán)限的安卓/IOSAPP成功后即可獲得移動應(yīng)用appid
time_stamp時間戳MString(32)當前的時間
nonce_str隨機字符串MString(32)隨機字符串
package訂單詳情擴展字符串MString(128)
sign_type簽名方式MString(32)簽名類型，支持RSA
partner_id從業(yè)機構(gòu)號MString(32)
sub_mch_id子商戶號CString(20)賬戶端子商戶號

示例

請求報文：

{
    "req_time": "20240621153714",
    "version": "3.0",
    "req_data": {
        "merchant_no": "822290059430BCY",
        "term_no": "D9285650",
        "out_trade_no": "720982165373671834096",
        "account_type": "ALIPAY",
        "trans_type": "41",
        "total_amount": 1,
        "notify_url": "http://47.105.146.241:9510/channelbacknotice/open/platform/transfer/V3",
        "location_info": {
            "request_ip": "192.168.23.165",
            "location": "+23.137208/+113.381982"
        },
        "subject": "測試"
    }
}復(fù)制

響應(yīng)報文：

{
    "code": "BBS00000",
    "msg": "成功",
    "resp_time": "20240626155843",
    "resp_data": {
        "merchant_no": "822290059430BCY",
        "out_trade_no": "720982165373671834096",
        "trade_no": "2024062666210315450047",
        "log_no": "66210315450047",
        "settle_merchant_no": "",
        "settle_term_no": "",
        "acc_resp_fields": {
            "code": "https://qr.alipay.com/bax01162hikpdvl7nk9t005f",
            "code_image": "",
            "prepay_id": "",
            "app_id": "",
            "pay_sign": "",
            "time_stamp": "",
            "nonce_str": "",
            "package": "",
            "sign_type": "",
            "form_data": "",
            "redirect_url": "",
            "best_pay_info": ""
        }
    }
}復(fù)制


The End

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