被掃預(yù)授權(quán)下單
說明
1: 收銀員使用掃碼設(shè)備讀取用戶微信、支付寶錢包“付款碼”后，將條碼信息和訂單信息通過本接口上送發(fā)起資金凍結(jié)。
2: 發(fā)起預(yù)授權(quán)后若30天內(nèi)未發(fā)起預(yù)授權(quán)完成，系統(tǒng)會(huì)自動(dòng)發(fā)起預(yù)授權(quán)撤銷將凍結(jié)資金回退用戶
請(qǐng)求URL
測(cè)試環(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
請(qǐng)求參數(shù)
| 屬性 | 說明 | 必選 | 類型 | 備注 |
|---|---|---|---|---|
| merId | 商戶號(hào) | M | String(32) | 拉卡拉分配的商戶號(hào) |
| termId | 終端號(hào) | M | String(32) | 拉卡拉分配的商戶號(hào) |
| authCode | 支付授權(quán)碼 | M | String(32) | 掃碼支付授權(quán)碼，設(shè)備讀取用戶APP中的條碼或者二維碼信息，用戶付款碼條形碼規(guī)則見說明 |
| amount | 金額 | M | String(12) | 單位分，整數(shù)型字符 |
| merReqSno | 商戶請(qǐng)求流水號(hào) | M | String(64) | 商戶系統(tǒng)唯一 |
| extendParams | 業(yè)務(wù)擴(kuò)展參數(shù) | C | object | 支付寶業(yè)務(wù)擴(kuò)展參數(shù) ，見說明 |
| scanType | 掃碼類型 | C | String(1) | 0或不填：掃碼支付 1：刷臉支付 |
| appid | 子商戶公眾賬號(hào)ID sub_appid | C | String(32) | 微信公眾平臺(tái)基本配置中的AppID(應(yīng)用ID)，傳入后支付成功可返回對(duì)應(yīng)公眾號(hào)下的用戶openid，只對(duì)微信支付有效 |
| goodsDetail | 商品詳情 | C | String(6000) | 訂單包含的商品列表信息，Json格式。 |
| subject | 訂單標(biāo)題 | M | String(128) | 標(biāo)題，用于簡(jiǎn)單描述訂單或商品 |
| exterMerOrderNo | 外部商戶訂單號(hào) | C | String(32) | 商品訂單號(hào)，如動(dòng)態(tài)碼關(guān)聯(lián)的某個(gè)商品訂單號(hào)，每個(gè)外部訂單來源下的外部商戶訂單號(hào)不可重復(fù)。 |
| exterOrderSource | 外部訂單來源 | C | String(16) | |
| settleType | 結(jié)算類型 | C | String(4) | “0”或者空，常規(guī)結(jié)算方式；“1”-暫緩結(jié)算方式 |
| goodsTag | 訂單優(yōu)惠標(biāo)記 | C | String(32) | 訂單優(yōu)惠標(biāo)記，微信平臺(tái)配置的商品標(biāo)記，用于優(yōu)惠券或者滿減使用，accountType為WECHAT時(shí)，可選填此字段 |
| promoInfo | 營銷信息 | C | String(2048) | 優(yōu)惠相關(guān)信息，JSON格式 |
| upOrderInfo | 銀聯(lián)訂單信息 | C | String(600) | 銀聯(lián)二維碼單品營銷時(shí)上送 |
| upGoodsInfo | 銀聯(lián)商品信息 | C | String(6000) | 銀聯(lián)單品營銷商品信息 |
| expiredDays | 預(yù)授權(quán)期限 | C | String(12) | ~ 整數(shù)，天數(shù) |
| expiredStrategy | 預(yù)授權(quán)過期策略 | C | String(8) | CANCEL-撤銷（默認(rèn)）COMPLETE-完成 |
支持的authCode說明
| 屬性 | 說明 | 備注 |
|---|---|---|
| 微信 | 付款碼10 11 12 13 14 15開頭 | |
| 支付寶 | ALI | 付款碼25 26 27 28 29 30開頭 |
| 銀聯(lián) | UNION | 付款碼62開頭 |
| 翼支付 | BESTPAY | 付款碼51開頭 |
| 蘇寧 | SUNING | 付款碼83開頭 |
響應(yīng)參數(shù)
| 屬性 | 說明 | 必選 | 類型 | 備注 |
|---|---|---|---|---|
| labsNo | 平臺(tái)交易單號(hào) | M | String(32) | 平臺(tái)交易單號(hào) |
| tradeTime | 平臺(tái)交易時(shí)間 | M | String(14) | 平臺(tái)交易時(shí)間yyyyMMddHHmmss |
| merReqSno | 商戶請(qǐng)求流水號(hào) | M | String(64) | 如果請(qǐng)求中攜帶，則返回 |
| amount | 訂單金額 | C | String(12) | 單位分，整數(shù)數(shù)字型字符 |
| accountType | 錢包類型 | C | String(16) | 微信：WECHAT 支付寶：ALIPAY 銀聯(lián)：UQRCODEPAY 翼支付: BESTPAY 蘇寧易付寶: SUNING數(shù)字貨幣：DCPAY |
| accountChannelOrderNo | 賬戶端交易訂單號(hào) | C | String(32) | 賬戶端交易訂單號(hào)，支付通道返回的訂單號(hào)，等于被掃支付接口中的weOrderNo |
| lklOrderNo | 拉卡拉商戶訂單號(hào) | M | String(32) | SAAS生成的交易流水 |
| logNo | 拉卡拉對(duì)賬單流水號(hào)(計(jì)劃中) | M | String(14) | lklOrderNo的后14位 |
| needQuery | 是否需要發(fā)起查詢 | M | String(32) | 0=不需要 1=需要 當(dāng)返回1時(shí)，代表訂單處理中，商戶需主動(dòng)發(fā)起查詢 |
| openId | 用戶標(biāo)識(shí) | C | String(128) | 用戶在商戶appid下的唯一標(biāo)識(shí) |
| subOpenId | 用戶子標(biāo)識(shí) | C | String(128) | 用戶在子商戶appid下的唯一標(biāo)識(shí) |
| bankType | 付款銀行 | C | String(128) | 付款銀行 |
| payerAccountAmt | 付款人實(shí)際支付金額 | C | String(12) | |
| settleAmtAccCh | 賬戶端應(yīng)結(jié)訂單金額 | C | String(12) | 應(yīng)結(jié)訂單金額，單位分 |
| promoAmtAccChMer | 商戶優(yōu)惠金額（賬戶端） | C | String(12) | 賬戶端返回商戶優(yōu)惠金額，單位分 |
| promoAmtAccCh | 賬戶端優(yōu)惠金額（賬戶端） | C | String(12) | 賬戶端返回賬戶端優(yōu)惠金額，單位分 |
| activityId | 活動(dòng) ID | C | String(32) | 在賬戶端商戶后臺(tái)配置的批次 ID |
| upIssAddnData | 銀聯(lián)單品營銷 附加數(shù)據(jù) | C | String(8000) | 參與單品營銷優(yōu)惠時(shí)返回 |
| upCouponInfo | 銀聯(lián)優(yōu)惠信息出資方信息 | C | String(500) | 參與單品營銷優(yōu)惠時(shí)返回?cái)?shù)字貨幣中行返回示例說明：[{“fundchannel”:”BOC”,”amount”:”18”}] |
*authCode為UQRCODEPAY的銀聯(lián)付款碼若要支持銀聯(lián)單品營銷功能，需要上送參數(shù)orderInfo、goodsDetail、termExtInfo中的termSN、termType，響應(yīng)參數(shù)會(huì)新增issAddnData、couponInfo。
示例報(bào)文
錯(cuò)誤碼
| 錯(cuò)誤碼 | 描述 | 備注 |
|---|---|---|
| 000000 | 交易成功 |
The End