被掃合單交易請(qǐng)求報(bào)文

好拓客 5個(gè)月前 ( 11-20 ) 215

說明：被掃支付場(chǎng)景，可能存在支付中需要用戶輸入密碼的情況。該情況下一般交易會(huì)返回“BBS10000-支付中”狀態(tài)。在該場(chǎng)景下，建議發(fā)起方發(fā)起多次查詢，查詢頻率推薦1分鐘內(nèi)按 5s+5s+5s+5s+10S+10S+20S方式聯(lián)機(jī)查詢，并保留手工發(fā)起查詢的能力。


調(diào)用地址

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

URL(測(cè)試環(huán)境)：

URL(測(cè)試環(huán)境外網(wǎng))： https://test.wsmsd.cn/sit/api/v3/labs/trans/merge/micropay

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


請(qǐng)求報(bào)文

字段名中文名稱是否必填類型說明
merchant_no商戶號(hào)MString(32)拉卡拉分配的商戶號(hào)
term_no終端號(hào)MString(32)拉卡拉分配的業(yè)務(wù)終端號(hào)
out_trade_no商戶交易流水號(hào)MString(32)商戶系統(tǒng)唯一，不可重復(fù)
out_split_info商戶拆單信息MList<>拆單信息,詳細(xì)字段見out_split_info字段說明
auth_code支付授權(quán)碼MString(32)掃碼支付授權(quán)碼，設(shè)備讀取用戶APP中的條碼或者二維碼信息，用戶付款碼條形碼規(guī)則見說明
total_amount金額MString(12)單位分，整數(shù)型字符
location_info地址位置信息MObject地址位置信息，風(fēng)控要求必送
busi_mode業(yè)務(wù)模式CString(8)業(yè)務(wù)模式： ACQ-收單 PAY-付款 不填，默認(rèn)為“ACQ-收單”
subject訂單標(biāo)題CString(42)標(biāo)題，用于簡(jiǎn)單描述訂單或商品（賬戶端控制，實(shí)際最多42個(gè)字符）
notify_url商戶通知地址CString(128)商戶通知地址，如上傳，且 pay_order_no 不存在情況下，且支付響應(yīng)報(bào)文是交易中狀態(tài)的場(chǎng)景下，則按此地址通知商戶
scan_type掃碼類型CString(1)0或不填：掃碼支付 1：刷臉支付
identity_info身份信息CString(1024)實(shí)名支付信息，json字符串，如{“identityNo”:”32000000000000000X”,”name”:”張三”} ，然后國(guó)密sm2加密
acc_busi_fields賬戶端業(yè)務(wù)信息域CObject參見以下acc_busi_fields字段詳細(xì)說明,不同類型的auth_code對(duì)應(yīng)不同的賬戶端，需要填寫不同的信息
remark備注CString(128)備注信息

out_split_info字段說明

字段名中文名稱是否必填類型說明
out_sub_trade_no外部子交易流水號(hào)MString(32)商戶子交易流水號(hào)，商戶號(hào)下唯一
merchant_no商戶號(hào)MString(32)拉卡拉分配的商戶號(hào)
term_no終端號(hào)MString(32)拉卡拉分配的業(yè)務(wù)終端號(hào)
amount金額MString(12)單位分，整數(shù)型字符
settle_type結(jié)算類型（合單）CString(4)“0”或者空，常規(guī)結(jié)算方式
sub_remark子單備注CString(64)子單備注信息


說明： 

1）拆單信息域中商戶號(hào)不可重復(fù)；

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

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

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

支持的auth_code說明

屬性說明備注
微信WECHAT付款碼10 11 12 13 14 15開頭
支付寶ALIPAY付款碼25 26 27 28 29 30開頭

location_info字段說明

字段名中文名稱是否必填類型說明
request_ip請(qǐng)求方IP地址MString(64)請(qǐng)求方的IP地址，存在必填，格式如36.45.36.95
base_station基站信息CString(128)客戶端設(shè)備的基站信息（主掃時(shí)基站信息使用該字段）
location維度,經(jīng)度CString(32)商戶終端的地理位置，存在必填 格式：緯度,經(jīng)度，+表示北緯、東經(jīng)，-表示南緯、 西經(jīng)，精度最長(zhǎng)支持小數(shù)點(diǎn)后9位。舉例:+37.123456789,-121.123456789

支付寶二維碼被掃場(chǎng)景下acc_busi_fields域內(nèi)容

字段名中文名稱是否必填類型說明
extend_params業(yè)務(wù)擴(kuò)展參數(shù)Cobject支付寶業(yè)務(wù)擴(kuò)展參數(shù) ，主要用于花唄分期，見extend_params字段說明
business_params商戶傳入業(yè)務(wù)信息CString(512)商戶傳入業(yè)務(wù)信息，應(yīng)用于安全，營(yíng)銷 等參數(shù)直傳場(chǎng)景，格式為 json 格式。
goods_detail商品詳情CString(6000)訂單包含的商品列表信息，Json格式。見“支付寶goods_detail字段說明”
store_id商戶門店編號(hào)CString(32)支付寶收單上送
alipay_store_id支付寶店鋪編號(hào)CString(32)支付寶收單上送

支付寶extend_params字段說明

字段名中文名稱是否必填類型說明
sys_service_provider_id服務(wù)商的PIDCString(64)系統(tǒng)商編號(hào)，該參數(shù)作為系統(tǒng)商返傭數(shù)據(jù)提取的依據(jù)，請(qǐng)?zhí)顚懴到y(tǒng)商簽約協(xié)議的 PID
hb_fq_num花唄分期期數(shù)MString(5)支付寶花唄分期必送字段: 花唄分期數(shù) 3：3期 6：6期 12：12期
hb_fq_seller_percent賣家承擔(dān)手續(xù)費(fèi)比例MString(3)支付寶花唄分期必送字段: 賣家承擔(dān)收費(fèi)比例，商家承擔(dān)手續(xù)費(fèi)傳入100，用戶承擔(dān)手續(xù)費(fèi)傳入0，僅支持傳入100、0兩種，其他比例暫不支持 100：代表商家貼息 0：代表用戶承擔(dān)手續(xù)費(fèi)

支付寶goods_detail字段說明(暫不支持)

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

微信二維碼被掃場(chǎng)景下acc_busi_fileds域內(nèi)容

字段名中文名稱是否必填類型說明
sub_appid子商戶公眾賬號(hào)ID sub_appidCString(32)微信公眾平臺(tái)基本配置中的AppID(應(yīng)用ID)，傳入后支付成功可返回對(duì)應(yīng)公眾號(hào)下的用戶openid，只對(duì)微信支付有效
detail商品詳情CString(1024)單品優(yōu)惠功能字段，json字符串格式，內(nèi)容見以下“微信detail字段說明”
goods_tag訂單優(yōu)惠標(biāo)記CString(32)訂單優(yōu)惠標(biāo)記，微信平臺(tái)配置的商品標(biāo)記，用于優(yōu)惠券或者滿減使用，accountType為WECHAT時(shí)，可選填此字段

微信detail字段說明(暫不支持)

字段名中文名稱是否必填類型說明
cost_price
CString(12)1.商戶側(cè)一張小票訂單可能被分多次支付，訂單原 價(jià)用于記錄整張小票的交易金額。 2.當(dāng)訂單原價(jià)與支付金額不相等，則不享受優(yōu)惠。 3.該字段主要用于防止同一張小票分多次支付，以 享受多次優(yōu)惠的情況，正常支付訂單不必上傳此參 數(shù)。 如：608800
receipt_id
CString(12)商家小票 ID
goods_detail
MString(512)json字符串，內(nèi)容見以下“微信goods_detail字段說明”

微信goods_detail字段說明

字段名中文名稱是否必填類型說明
goods_id
MString(32)由半角的大小寫字母、數(shù)字、中劃線、下劃線中的一種或幾種組成。如“商品編碼”
wxpay_goods_id
CString(32)微信支付定義的統(tǒng)一商品編號(hào)
goods_name
CString(256)商品的實(shí)際名稱
quantity
MString(12)用戶購(gòu)買的數(shù)量
price
MString(12)單位為：分。如果商戶有優(yōu)惠，需傳輸商戶優(yōu)惠后的單價(jià)


響應(yīng)報(bào)文

字段名中文名稱是否必填類型說明
need_query是否需要發(fā)起查詢MString(32)0=不需要 1=需要 當(dāng)返回1時(shí)，代表訂單處理中，商戶需主動(dòng)發(fā)起查詢
merchant_no商戶號(hào)（待上線）MString(32)拉卡拉分配的商戶號(hào)（請(qǐng)求接口中商戶號(hào)）
out_trade_no商戶交易流水號(hào)MString(32)請(qǐng)求報(bào)文中的商戶交易流水號(hào)
trade_no拉卡拉交易流水號(hào)MString(32)拉卡拉交易流水號(hào)
log_no拉卡拉對(duì)賬單流水號(hào)MString(14)拉卡拉對(duì)賬單流水號(hào)
acc_trade_no賬戶端交易訂單號(hào)CString(32)賬戶端交易流水號(hào)
account_type錢包類型MString(16)微信：WECHAT 支付寶：ALIPAY 銀聯(lián)：UQRCODEPAY 翼支付: BESTPAY 蘇寧易付寶: SUNING 數(shù)字貨幣：DCPAY
total_amount訂單金額MString(12)單位分，整數(shù)數(shù)字型字符
payer_amount付款人實(shí)際發(fā)生金額MString(12)
acc_settle_amount賬戶端應(yīng)結(jié)訂單金額MString(12)應(yīng)結(jié)訂單金額，單位分
acc_mdiscount_amount商戶優(yōu)惠金額（賬戶端）CString(12)賬戶端返回商戶優(yōu)惠金額，單位分
acc_discount_amount賬戶端優(yōu)惠金額CString(12)賬戶端返回賬戶端優(yōu)惠金額，單位分
trade_time交易完成時(shí)間MString(14)以賬戶端返回時(shí)間為準(zhǔn)
bank_type付款銀行CString(128)付款銀行
card_type銀行卡類型CString(16)01：借記卡 02：貸記卡
split_info拆單信息MList<>拆單信息見split_info域說明
acc_resp_fields賬戶端返回信息域CObject賬戶端返回信息域

split_info域信息

字段名中文名稱是否必填類型說明
sub_trade_no子單交易流水號(hào)MString(32)子單交易流水號(hào)
sub_log_no子單對(duì)賬單流水號(hào)MString(14)子單對(duì)賬單流水號(hào)
out_sub_trade_no外部子交易流水號(hào)MString(32)商戶子交易流水號(hào)，商戶號(hào)下唯一
merchant_no商戶號(hào)MString(32)拉卡拉分配的商戶號(hào)
merchant_name商戶名稱MString(64)商戶名稱
term_no終端號(hào)MString(32)拉卡拉分配的業(yè)務(wù)終端號(hào)
amount金額MString(12)單位分，整數(shù)型字符

支付寶二維碼被掃場(chǎng)景下返回acc_resp_fields域內(nèi)容

字段名中文名稱是否必填類型說明
user_id買家在支付寶的用戶idMString(64)buyer_user_id
store_id商戶門店編號(hào)CString(32)
alipay_store_id支付寶的店鋪編號(hào)CString(32)
sub_mch_id子商戶號(hào)CString(20)賬戶端子商戶號(hào)

微信二維碼被掃場(chǎng)景下返回acc_resp_fields域內(nèi)容

字段名中文名稱是否必填類型說明
store_id商戶門店編號(hào)CString(32)
alipay_store_id支付寶的店鋪編號(hào)CString(32)
open_id用戶標(biāo)識(shí)MString(64)用戶在商戶appid下的唯一標(biāo)識(shí)
user_id用戶子標(biāo)識(shí)CString(64)sub_open_id
sub_mch_id子商戶號(hào)CString(20)賬戶端子商戶號(hào)
acc_activity_id活動(dòng) IDCString(32)在賬戶端商戶后臺(tái)配置的批次 ID


示例

請(qǐng)求報(bào)文：

{
    "req_time":"20210907150256",
    "version":"3.0",
    "out_org_code":"OP00000003",
    "req_data":{
        "merchant_no":"822290070111135",
        "term_no":"29034705",
        "out_trade_no":"FD660E1FAA3A4470933CDEDAE1EC1D8E",
        "auth_code":"135178236713755038",
        "total_amount":"123",
        "location_info":{
            "request_ip":"10.176.1.192",
            "location":"+37.123456789,-121.123456789"
        },
        "out_order_no":"08F4542EEC6A4497BC419161747A92FA"
    }
}
復(fù)制

響應(yīng)報(bào)文：

{
    "msg":"用戶支付中",
    "resp_time":"20210907150258",
    "code":"BBS10000",
    "resp_data":{
        "need_query":"1",
        "out_trade_no":"FD660E1FAA3A4470933CDEDAE1EC1D8E",
        "trade_no":"2021090766210003630077",
        "log_no":"66210003630077",
        "acc_trade_no":"",
        "account_type":"WECHAT",
        "total_amount":"123",
        "payer_amount":"",
        "acc_settle_amount":"",
        "acc_mdiscount_amount":"",
        "acc_discount_amount":"",
        "trade_time":"20210907150258",
        "bank_type":"",
        "card_type":""
    }
}
復(fù)制



The End

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