被掃預授權下單

拉卡拉支付 7個月前 ( 11-20 ) 308

說明

1: 收銀員使用掃碼設備讀取用戶微信、支付寶錢包“付款碼”后,將條碼信息和訂單信息通過本接口上送發(fā)起資金凍結(jié)。

2: 發(fā)起預授權后若30天內(nèi)未發(fā)起預授權完成,系統(tǒng)會自動發(fā)起預授權撤銷將凍結(jié)資金回退用戶

請求URL

測試環(huán)境:https://test.wsmsd.cn/sit/api/v2/labs/txn/preAuth/preAuth
生產(chǎn)環(huán)境:https://s2.lakala.com/api/v2/labs/txn/preAuth/preAuth

請求參數(shù)

屬性說明必選類型備注
merId商戶號MString(32)拉卡拉分配的商戶號
termId終端號MString(32)拉卡拉分配的商戶號
authCode支付授權碼MString(32)掃碼支付授權碼,設備讀取用戶APP中的條碼或者二維碼信息,用戶付款碼條形碼規(guī)則見說明
amount金額MString(12)單位分,整數(shù)型字符
merReqSno商戶請求流水號MString(64)商戶系統(tǒng)唯一
extendParams業(yè)務擴展參數(shù)Cobject支付寶業(yè)務擴展參數(shù) ,見說明
scanType掃碼類型CString(1)0或不填:掃碼支付 1:刷臉支付
appid子商戶公眾賬號ID sub_appidCString(32)微信公眾平臺基本配置中的AppID(應用ID),傳入后支付成功可返回對應公眾號下的用戶openid,只對微信支付有效
goodsDetail商品詳情CString(6000)訂單包含的商品列表信息,Json格式。
subject訂單標題MString(128)標題,用于簡單描述訂單或商品
exterMerOrderNo外部商戶訂單號CString(32)商品訂單號,如動態(tài)碼關聯(lián)的某個商品訂單號,每個外部訂單來源下的外部商戶訂單號不可重復。
exterOrderSource外部訂單來源CString(16)
settleType結(jié)算類型CString(4)“0”或者空,常規(guī)結(jié)算方式;“1”-暫緩結(jié)算方式
goodsTag訂單優(yōu)惠標記CString(32)訂單優(yōu)惠標記,微信平臺配置的商品標記,用于優(yōu)惠券或者滿減使用,accountType為WECHAT時,可選填此字段
promoInfo營銷信息CString(2048)優(yōu)惠相關信息,JSON格式
upOrderInfo銀聯(lián)訂單信息CString(600)銀聯(lián)二維碼單品營銷時上送
upGoodsInfo銀聯(lián)商品信息CString(6000)銀聯(lián)單品營銷商品信息
expiredDays預授權期限CString(12)~ 整數(shù),天數(shù)
expiredStrategy預授權過期策略CString(8)CANCEL-撤銷(默認)COMPLETE-完成

支持的authCode說明

屬性說明備注
微信WECHAT付款碼10 11 12 13 14 15開頭
支付寶ALI付款碼25 26 27 28 29 30開頭
銀聯(lián)UNION付款碼62開頭
翼支付BESTPAY付款碼51開頭
蘇寧SUNING付款碼83開頭

響應參數(shù)

屬性說明必選類型備注
labsNo平臺交易單號MString(32)平臺交易單號
tradeTime平臺交易時間MString(14)平臺交易時間yyyyMMddHHmmss
merReqSno商戶請求流水號MString(64)如果請求中攜帶,則返回
amount訂單金額CString(12)單位分,整數(shù)數(shù)字型字符
accountType錢包類型CString(16)微信:WECHAT 支付寶:ALIPAY 銀聯(lián):UQRCODEPAY 翼支付: BESTPAY 蘇寧易付寶: SUNING數(shù)字貨幣:DCPAY
accountChannelOrderNo賬戶端交易訂單號CString(32)賬戶端交易訂單號,支付通道返回的訂單號,等于被掃支付接口中的weOrderNo
lklOrderNo拉卡拉商戶訂單號MString(32)SAAS生成的交易流水
logNo拉卡拉對賬單流水號(計劃中)MString(14)lklOrderNo的后14位
needQuery是否需要發(fā)起查詢MString(32)0=不需要 1=需要 當返回1時,代表訂單處理中,商戶需主動發(fā)起查詢
openId用戶標識CString(128)用戶在商戶appid下的唯一標識
subOpenId用戶子標識CString(128)用戶在子商戶appid下的唯一標識
bankType付款銀行CString(128)付款銀行
payerAccountAmt付款人實際支付金額CString(12)
settleAmtAccCh賬戶端應結(jié)訂單金額CString(12)應結(jié)訂單金額,單位分
promoAmtAccChMer商戶優(yōu)惠金額(賬戶端)CString(12)賬戶端返回商戶優(yōu)惠金額,單位分
promoAmtAccCh賬戶端優(yōu)惠金額(賬戶端)CString(12)賬戶端返回賬戶端優(yōu)惠金額,單位分
activityId活動 IDCString(32)在賬戶端商戶后臺配置的批次 ID
upIssAddnData銀聯(lián)單品營銷 附加數(shù)據(jù)CString(8000)參與單品營銷優(yōu)惠時返回
upCouponInfo銀聯(lián)優(yōu)惠信息出資方信息CString(500)參與單品營銷優(yōu)惠時返回數(shù)字貨幣中行返回示例說明:[{“fundchannel”:”BOC”,”amount”:”18”}]

*authCode為UQRCODEPAY的銀聯(lián)付款碼若要支持銀聯(lián)單品營銷功能,需要上送參數(shù)orderInfo、goodsDetail、termExtInfo中的termSN、termType,響應參數(shù)會新增issAddnData、couponInfo。

示例報文

錯誤碼

錯誤碼描述備注
000000交易成功


The End