拉卡拉掃碼預(yù)授權(quán)下單API請求參數(shù)

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

說明

1：用戶使用微信、支付寶錢包主動掃描商家聚合碼，將訂單信息通過本接口上送發(fā)起資金凍結(jié)。

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

請求URL

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

請求參數(shù)

屬性	說明	必選	類型	備注
merId	商戶號	M	String(32)	拉卡拉分配的商戶號
termId	終端號	M	String(32)	拉卡拉分配的商戶號
accountType	錢包類型	M	String(32)	微信：WECHAT 支付寶：ALIPAY 銀聯(lián)：UQRCODEPAY 翼支付: BESTPAY 蘇寧易付寶: SUNING 數(shù)字貨幣：DCPAY
amount	金額	M	String(12)	單位分，整數(shù)型字符
appId	子商戶公眾賬號ID	C	String(32)	微信分配的子商戶公眾賬號ID，sub_appid（即微信小程序支付-71、公眾號支付-51），此參數(shù)必傳，只對微信支付有效工行數(shù)字錢包情況下，該字段上送工行的openId
openId	用戶標識	C	String(128)	用戶在子商戶appid下的唯一標識，sub_openid，（即微信小程序支付-71、眾號支付-51），此參數(shù)必傳，只對微信支付有效注：建議使用靜默授權(quán) 微信公眾號為用戶的 openid 支付寶服務(wù)窗為用戶的 buyer_id 銀聯(lián)JS支付為用戶的 userId，獲取用戶授權(quán)返回00時必傳翼支付不需要上送工行數(shù)字錢包情況下，該字段上送工行的subOpenId
transType	接入方式	C	String(2)	61:微信APP支付（銀聯(lián)不支持，微信支持，需直連微信） 71:微信小程序支付 41:NATIVE（掃碼支付）（WECHAT暫不支持） 51:JSAPI（微信公眾號支付，支付寶服務(wù)窗支付，銀聯(lián)JS支付，翼支付JS支付、數(shù)字貨幣錢包支付）
merReqSno	商戶請求流水號	M	String(64)	商戶系統(tǒng)唯一，對應(yīng)數(shù)據(jù)庫表中外部請求流水號。
exterMerOrderNo	外部商戶訂單號	C	String(32)	商品訂單號，如動態(tài)碼關(guān)聯(lián)的某個商品訂單號，每個外部訂單來源下的外部商戶訂單號不可重復(fù)。
exterOrderSource	外部訂單來源	C	String(16)
settleType	結(jié)算類型	C	String(4)	“0”或者空，常規(guī)結(jié)算方式；“1”-暫緩結(jié)算方式
goodsDetail	商品詳情	C	String(6000)	訂單包含的商品列表信息，Json格式。
subject	訂單標題	M	String(128)	標題，用于簡單描述訂單或商品主題（賬戶端控制，實際最多42個字符）
goodsDesp	商品優(yōu)惠描述	C	String(128)	優(yōu)惠場景使用，送往賬戶端
remark	備注	C	String(128)
goodsTag	訂單優(yōu)惠標記	C	String(32)	訂單優(yōu)惠標記，微信平臺配置的商品標記，用于優(yōu)惠券或者滿減使用，accountType為WECHAT時，可選填此字段
attach	附加域	C	String(128)	附加數(shù)據(jù)，在查詢API和支付通知中原樣返回，該字段主要用于商戶攜帶訂單的自定義數(shù)據(jù)。商戶定制字段，直接送到賬戶端。
extendParams	業(yè)務(wù)擴展參數(shù)	C	object	支付寶業(yè)務(wù)擴展參數(shù) ，見說明
promoInfo	優(yōu)惠信息	C	String(2048)	優(yōu)惠相關(guān)信息，JSON格式
upOrderInfo	銀聯(lián)訂單信息	C	String(600)	銀聯(lián)單品營銷訂單信息
upGoodsInfo	銀聯(lián)商品信息	C	String(6000)	銀聯(lián)單品營銷商品信息
frontUrl	銀聯(lián)前臺通知地址	C	String(256)	收款方向銀聯(lián)推送訂單時上送的前臺通知地址（僅允許為外網(wǎng)地址），用戶完成支付點擊，“返回”后，銀聯(lián)通過瀏覽器POST請求到該地址。當transType為JSAPI，payMode為UQRCODEPAY時，可選填此字段
frontFailUrl	銀聯(lián)失敗交易前臺通知地址	C	String(256)	收款方向銀聯(lián)推送訂單時上送的失敗交易前臺通知地址（僅允許為外網(wǎng)地址），用戶支付過程中交易失敗，點擊“返回”后，銀聯(lián)通過瀏覽器GET請求到該地址。當transType為JSAPI，payMode為UQRCODEPAY時，可選填此字段，需與frontUrl同時出現(xiàn)，未上送默認為frontUrl的值
expiredStrategy	擔(dān)保過期策略	C	String(8)	CANCEL-撤銷 COMPLETE-完成（默認）
preOrderValidTime	預(yù)下單有效時間	C	String(2)	預(yù)下單的訂單的有效時間，以分鐘為單位。如果在有效時間內(nèi)沒有完成付款，則在賬戶端該訂單失效。如果不上送，以賬戶端訂單失效時間為準。建議不超過15分鐘。不傳值則默認5分鐘。

響應(yīng)參數(shù)

屬性	說明	必選	類型	備注
tradeTime	交易時間	M	String(14)	平臺交易時間yyyyMMddHHmmss
merReqSno	商戶請求流水號	M	String(64)	如果請求中攜帶，則返回
lklOrderNo	拉卡拉訂單號	M	String(32)	saas系統(tǒng)返回時，則返回
logNo	拉卡拉對賬單流水號(計劃中)	M	String(14)	lklOrderNo的后14位

transType=51(JSAPI) 時返回

payMode=WECHAT 時返回
屬性說明必選類型備注
paySign 支付簽名信息 C String(256) 簽名
appId 公眾號id C String(32) 商戶注冊具有支付權(quán)限的公眾號成功后即可獲得公眾號id
timeStamp 時間戳 C String(32) 當前的時間
nonceStr 隨機字符串 C String(32) 隨機字符串
package 訂單詳情擴展字符串 C String(128) 統(tǒng)一下單接口返回的prepay_id參數(shù)值
signType 簽名方式 C String(32) 簽名類型，支持RSA

屬性	說明	必選	類型	備注
paySign	支付簽名信息	C	String(256)	簽名
appId	公眾號id	C	String(32)	商戶注冊具有支付權(quán)限的公眾號成功后即可獲得公眾號id
timeStamp	時間戳	C	String(32)	當前的時間
nonceStr	隨機字符串	C	String(32)	隨機字符串
package	訂單詳情擴展字符串	C	String(128)	統(tǒng)一下單接口返回的prepay_id參數(shù)值
signType	簽名方式	C	String(32)	簽名類型，支持RSA

payMode=ALIPAY 時返回
屬性說明必選類型備注
prepayId 預(yù)下單Id C String(32) 預(yù)支付交易會話ID

payMode=UQRCODEPAY 時返回
屬性說明必選類型備注
redirectUrl 銀聯(lián)JS支付重定向地址 C String(256) 銀聯(lián)JS支付返回重定向地址

屬性	說明	必選	類型	備注
redirectUrl	銀聯(lián)JS支付重定向地址	C	String(256)	銀聯(lián)JS支付返回重定向地址

payMode=LKLACC 時返回
屬性說明必選類型備注
prepayId 預(yù)下單Id C String(32) 預(yù)支付交易會話ID

transType=41(NATIVE) 時返回

屬性	說明	必選	類型	備注
code	二維碼信息	C	String(256)	商戶可用此參數(shù)自定義去生成二維碼后展示出來進行掃碼支付
codeImage	二維碼圖片內(nèi)容	C	String(256)	商戶收款二維碼圖片。Base64編碼，暫無

transType=71(微信小程序支付) 時返回

屬性	說明	必選	類型	備注
prepayId	預(yù)下單Id	C	String(32)	預(yù)支付交易會話ID
paySign	支付簽名信息	C	String(256)	簽名
appId	小程序id	C	String(32)	商戶注冊具有支付權(quán)限的小程序成功后即可獲得小程序id
timeStamp	時間戳	C	String(32)	當前的時間
nonceStr	隨機字符串	C	String(32)	隨機字符串
package	訂單詳情擴展字符串	C	String(128)	統(tǒng)一下單接口返回的prepay_id參數(shù)值
signType	簽名方式	C	String(32)	簽名類型，支持RSA

transType=61(微信APP支付) 時返回

屬性	說明	必選	類型	備注
prepayId	預(yù)下單Id	C	String(32)	預(yù)支付交易會話ID
paySign	支付簽名信息	C	String(256)	簽名
appId	應(yīng)用id	C	String(32)	開放平臺審核通過的應(yīng)用APPID，為特約商戶申請的應(yīng)用APPID
timeStamp	時間戳	C	String(32)	當前的時間
nonceStr	隨機字符串	C	String(32)	隨機字符串
package	訂單詳情擴展字符串	C	String(128)	固定值 Sign=WXPay
partnerId	從業(yè)機構(gòu)號	C	String(32)	支付分配的從業(yè)機構(gòu)號

transType=81(支付寶H5支付) 時返回

屬性	說明	必選	類型	備注
formData	為開發(fā)者生成前臺頁面請求需要的完整form 表單的 html（不包含自動提交腳本），商戶可決定是否直接提交 form 表單，如需要直接提交的，可將這個表單的 String 加自動提交腳本輸出到 http response 中，如不需要直接提交的，可以自行決定中間處理過程，但提交至支付寶側(cè)的 form 表達內(nèi)容不可修改，否則會引起支付寶側(cè)報錯。	C	String(128)	為銀聯(lián)支付寶H5支付時，為開發(fā)者生成前臺頁面請求需要的完整form 表單的 html

NATIVE示例報文

NATIVE請求報文

{
    "reqData": {
        "mercId": "822100050210643",
        "termNo": "47846848",
        "payMode": "ALIPAY",
        "amount": "000000000001",
        "openId": "",
        "spbillCreateIp": "127.1.10",
        "transType": "41",
        "orderId": "20200728165211",
        "appId": "",
        "subject": "測試專用"
    },
    "ver": "1.0.0",
    "timestamp": "1541589957000",
    "reqId": "baff59de4694438ca9089862253517a5",
    "termExtInfo": {
        "termLoc": "+155621.316,-125622.12"
    }
}復(fù)制

NATIVE成功響應(yīng)報文

{
    "respData": {
        "tradeTime": "20200729150043",
        "code": "https://qr.alipay.com/bax01969llc2hqjjifvm50ff",
        "orderId": "20200728165211",
        "lklOrderId": "20200729110113200266211202870109"
    },
    "timestamp": 1596006044804,
    "rnd": null,
    "ver": "1.0.0",
    "reqId": "baff59de4694438ca9089862253517a5",
    "respId": null,
    "retCode": "000000",
    "retMsg": "交易成功",
    "cmdRetCode": "GLOBAL_SUCCESS"
}復(fù)制

NATIVE失敗響應(yīng)報文

{
    "retCode": "PT10FF",
    "retMsg": "生成訂單失敗",
    "sign": "",
    "timestamp": 1553823081169,
    "ver": "1.0.0"
}復(fù)制

JSAPI示例報文

JSAPI請求報文

{
    "reqData": {
        "mercId": "822162070120015",
        "termNo": "47827142",
        "payMode": "WECHAT",
        "amount": "000000000001",
        "openId": "olpr-0pHIp1AjaAr29LENlHi0cJ0",
        "spbillCreateIp": "127.0.0.1",
        "transType": "51",
        "orderId": "2020072915yhl1422",
        "appId": "wx9ef39b708f16694d",
        "subject": "測試專用"
    },
    "ver": "1.0.0",
    "timestamp": "1541589957000",
    "reqId": "baff59de4694438ca9089862253517a5",
    "termExtInfo": {
        "termLoc": "+155621.316/-125622.12"
    }
}復(fù)制

JSAPI成功響應(yīng)報文

{
    "respData": {
        "timeStamp": "1596008125",
        "tradeTime": "20200729153540",
        "package": "prepay_id=wx29153525159581b728038c9c1125323300",
        "paySign": "wWYfaNyyMuqAHVppUfQHXLGLUVcDeCyMsbiMbT9NSEiO2+Y/1uYSFS27LYINaF9f5OoI6MJFvpZfwFGCTVByoNWUH+vfyeK96ITTsy0w44ng2paqdWRHN0D9qtUyVUcbNcf2C5jQ05H65SHNI8oUnUbwlHgGe5AA4JFqKdqiODXQ4g47F11B5/a3masTmHtE7VyIU8nIXz9iPRJh28NiY2DRSX7KMU8OGZb6Y+sAi2fLqfkB9sVHnWD3BzuXDI5xIAVj3BvF3LR38/JWeR9mEqCuQLo7VdC5WnmnqZyVo6KFExNL5Gsin85AILz8S8ibOn4ADmU7sXs0LiJ2bc7K3Q==",
        "orderId": "2020072915yhl1422",
        "lklOrderId": "20200729110113100266211202870161",
        "appId": "wx2421b1c4370ec43b",
        "signType": "RSA",
        "nonceStr": "20ee06fc255a4606942470808e015112"
    },
    "timestamp": 1596008140382,
    "rnd": null,
    "ver": "1.0.0",
    "reqId": "baff59de4694438ca9089862253517a5",
    "respId": null,
    "retCode": "000000",
    "retMsg": "交易成功",
    "cmdRetCode": "GLOBAL_SUCCESS"
}復(fù)制

JSAPI失敗響應(yīng)報文

{
    "respData": null,
    "timestamp": 1596006460198,
    "rnd": null,
    "ver": "1.0.0",
    "reqId": "baff59de4694438ca9089862253517a5",
    "respId": null,
    "retCode": "BPS10028",
    "retMsg": "主掃支付失敗(參數(shù)錯誤)",
    "cmdRetCode": "PREPAY_ORDER_ERROR"
}復(fù)制

錯誤碼

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

The End

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

API文檔

說明