被扫预授权下单

拉卡拉支付 6天前 ( 11-20 19:59 ) 19

说明

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商户号MString(32)拉卡拉分配的商户号
termId终端号MString(32)拉卡拉分配的商户号
authCode支付授权码MString(32)扫码支付授权码,设备读取用户APP中的条码或者二维码信息,用户付款码条形码规则见说明
amount金额MString(12)单位分,整数型字符
merReqSno商户请求流水号MString(64)商户系统唯一
extendParams业务扩展参数Cobject支付宝业务扩展参数 ,见说明
scanType扫码类型CString(1)0或不填:扫码支付 1:刷脸支付
appid子商户公众账号ID sub_appidCString(32)微信公众平台基本配置中的AppID(应用ID),传入后支付成功可返回对应公众号下的用户openid,只对微信支付有效
goodsDetail商品详情CString(6000)订单包含的商品列表信息,Json格式。
subject订单标题MString(128)标题,用于简单描述订单或商品
exterMerOrderNo外部商户订单号CString(32)商品订单号,如动态码关联的某个商品订单号,每个外部订单来源下的外部商户订单号不可重复。
exterOrderSource外部订单来源CString(16)
settleType结算类型CString(4)“0”或者空,常规结算方式;“1”-暂缓结算方式
goodsTag订单优惠标记CString(32)订单优惠标记,微信平台配置的商品标记,用于优惠券或者满减使用,accountType为WECHAT时,可选填此字段
promoInfo营销信息CString(2048)优惠相关信息,JSON格式
upOrderInfo银联订单信息CString(600)银联二维码单品营销时上送
upGoodsInfo银联商品信息CString(6000)银联单品营销商品信息
expiredDays预授权期限CString(12)~ 整数,天数
expiredStrategy预授权过期策略CString(8)CANCEL-撤销(默认)COMPLETE-完成

支持的authCode说明

属性说明备注
微信WECHAT付款码10 11 12 13 14 15开头
支付宝ALI付款码25 26 27 28 29 30开头
银联UNION付款码62开头
翼支付BESTPAY付款码51开头
苏宁SUNING付款码83开头

响应参数

属性说明必选类型备注
labsNo平台交易单号MString(32)平台交易单号
tradeTime平台交易时间MString(14)平台交易时间yyyyMMddHHmmss
merReqSno商户请求流水号MString(64)如果请求中携带,则返回
amount订单金额CString(12)单位分,整数数字型字符
accountType钱包类型CString(16)微信:WECHAT 支付宝:ALIPAY 银联:UQRCODEPAY 翼支付: BESTPAY 苏宁易付宝: SUNING数字货币:DCPAY
accountChannelOrderNo账户端交易订单号CString(32)账户端交易订单号,支付通道返回的订单号,等于被扫支付接口中的weOrderNo
lklOrderNo拉卡拉商户订单号MString(32)SAAS生成的交易流水
logNo拉卡拉对账单流水号(计划中)MString(14)lklOrderNo的后14位
needQuery是否需要发起查询MString(32)0=不需要 1=需要 当返回1时,代表订单处理中,商户需主动发起查询
openId用户标识CString(128)用户在商户appid下的唯一标识
subOpenId用户子标识CString(128)用户在子商户appid下的唯一标识
bankType付款银行CString(128)付款银行
payerAccountAmt付款人实际支付金额CString(12)
settleAmtAccCh账户端应结订单金额CString(12)应结订单金额,单位分
promoAmtAccChMer商户优惠金额(账户端)CString(12)账户端返回商户优惠金额,单位分
promoAmtAccCh账户端优惠金额(账户端)CString(12)账户端返回账户端优惠金额,单位分
activityId活动 IDCString(32)在账户端商户后台配置的批次 ID
upIssAddnData银联单品营销 附加数据CString(8000)参与单品营销优惠时返回
upCouponInfo银联优惠信息出资方信息CString(500)参与单品营销优惠时返回数字货币中行返回示例说明:[{“fundchannel”:”BOC”,”amount”:”18”}]

*authCode为UQRCODEPAY的银联付款码若要支持银联单品营销功能,需要上送参数orderInfo、goodsDetail、termExtInfo中的termSN、termType,响应参数会新增issAddnData、couponInfo。

示例报文

错误码

错误码描述备注
000000交易成功


The End