被扫预授权下单
说明
1: 收银员使用扫码设备读取用户微信、支付宝钱包“付款码”后,将条码信息和订单信息通过本接口上送发起资金冻结。
2: 发起预授权后若30天内未发起预授权完成,系统会自动发起预授权撤销将冻结资金回退用户
请求URL
测试环境:https://test.wsmsd.cn/sit/api/v2/labs/txn/preAuth/preAuth
生产环境:https://s2.lakala.com/api/v2/labs/txn/preAuth/preAuth
请求参数
| 属性 | 说明 | 必选 | 类型 | 备注 |
|---|---|---|---|---|
| merId | 商户号 | M | String(32) | 拉卡拉分配的商户号 |
| termId | 终端号 | M | String(32) | 拉卡拉分配的商户号 |
| authCode | 支付授权码 | M | String(32) | 扫码支付授权码,设备读取用户APP中的条码或者二维码信息,用户付款码条形码规则见说明 |
| amount | 金额 | M | String(12) | 单位分,整数型字符 |
| merReqSno | 商户请求流水号 | M | String(64) | 商户系统唯一 |
| extendParams | 业务扩展参数 | C | object | 支付宝业务扩展参数 ,见说明 |
| scanType | 扫码类型 | C | String(1) | 0或不填:扫码支付 1:刷脸支付 |
| appid | 子商户公众账号ID sub_appid | C | String(32) | 微信公众平台基本配置中的AppID(应用ID),传入后支付成功可返回对应公众号下的用户openid,只对微信支付有效 |
| goodsDetail | 商品详情 | C | String(6000) | 订单包含的商品列表信息,Json格式。 |
| subject | 订单标题 | M | String(128) | 标题,用于简单描述订单或商品 |
| exterMerOrderNo | 外部商户订单号 | C | String(32) | 商品订单号,如动态码关联的某个商品订单号,每个外部订单来源下的外部商户订单号不可重复。 |
| exterOrderSource | 外部订单来源 | C | String(16) | |
| settleType | 结算类型 | C | String(4) | “0”或者空,常规结算方式;“1”-暂缓结算方式 |
| goodsTag | 订单优惠标记 | C | String(32) | 订单优惠标记,微信平台配置的商品标记,用于优惠券或者满减使用,accountType为WECHAT时,可选填此字段 |
| promoInfo | 营销信息 | C | String(2048) | 优惠相关信息,JSON格式 |
| upOrderInfo | 银联订单信息 | C | String(600) | 银联二维码单品营销时上送 |
| upGoodsInfo | 银联商品信息 | C | String(6000) | 银联单品营销商品信息 |
| expiredDays | 预授权期限 | C | String(12) | ~ 整数,天数 |
| expiredStrategy | 预授权过期策略 | C | String(8) | CANCEL-撤销(默认)COMPLETE-完成 |
支持的authCode说明
| 属性 | 说明 | 备注 |
|---|---|---|
| 微信 | 付款码10 11 12 13 14 15开头 | |
| 支付宝 | ALI | 付款码25 26 27 28 29 30开头 |
| 银联 | UNION | 付款码62开头 |
| 翼支付 | BESTPAY | 付款码51开头 |
| 苏宁 | SUNING | 付款码83开头 |
响应参数
| 属性 | 说明 | 必选 | 类型 | 备注 |
|---|---|---|---|---|
| labsNo | 平台交易单号 | M | String(32) | 平台交易单号 |
| tradeTime | 平台交易时间 | M | String(14) | 平台交易时间yyyyMMddHHmmss |
| merReqSno | 商户请求流水号 | M | String(64) | 如果请求中携带,则返回 |
| amount | 订单金额 | C | String(12) | 单位分,整数数字型字符 |
| accountType | 钱包类型 | C | String(16) | 微信:WECHAT 支付宝:ALIPAY 银联:UQRCODEPAY 翼支付: BESTPAY 苏宁易付宝: SUNING数字货币:DCPAY |
| accountChannelOrderNo | 账户端交易订单号 | C | String(32) | 账户端交易订单号,支付通道返回的订单号,等于被扫支付接口中的weOrderNo |
| lklOrderNo | 拉卡拉商户订单号 | M | String(32) | SAAS生成的交易流水 |
| logNo | 拉卡拉对账单流水号(计划中) | M | String(14) | lklOrderNo的后14位 |
| needQuery | 是否需要发起查询 | M | String(32) | 0=不需要 1=需要 当返回1时,代表订单处理中,商户需主动发起查询 |
| openId | 用户标识 | C | String(128) | 用户在商户appid下的唯一标识 |
| subOpenId | 用户子标识 | C | String(128) | 用户在子商户appid下的唯一标识 |
| bankType | 付款银行 | C | String(128) | 付款银行 |
| payerAccountAmt | 付款人实际支付金额 | C | String(12) | |
| settleAmtAccCh | 账户端应结订单金额 | C | String(12) | 应结订单金额,单位分 |
| promoAmtAccChMer | 商户优惠金额(账户端) | C | String(12) | 账户端返回商户优惠金额,单位分 |
| promoAmtAccCh | 账户端优惠金额(账户端) | C | String(12) | 账户端返回账户端优惠金额,单位分 |
| activityId | 活动 ID | C | String(32) | 在账户端商户后台配置的批次 ID |
| upIssAddnData | 银联单品营销 附加数据 | C | String(8000) | 参与单品营销优惠时返回 |
| upCouponInfo | 银联优惠信息出资方信息 | C | String(500) | 参与单品营销优惠时返回数字货币中行返回示例说明:[{“fundchannel”:”BOC”,”amount”:”18”}] |
*authCode为UQRCODEPAY的银联付款码若要支持银联单品营销功能,需要上送参数orderInfo、goodsDetail、termExtInfo中的termSN、termType,响应参数会新增issAddnData、couponInfo。
示例报文
错误码
| 错误码 | 描述 | 备注 |
|---|---|---|
| 000000 | 交易成功 |
The End
