预授权
API endpoint: {api_domain}/api/lite-pos/v1/authorization/initial
Verb: POST
Signature :需要签名,参考统一签名说明
请求参数:
参数 | 出现 | 类型 | 约束 | 描述 |
---|---|---|---|---|
request_id | 1 | String | 字符串,最大64位 | 请求编号,每次请求必须唯一;表示每一次请求时不同的业务,如果第一次请求业务失败了,再次请求,可以用于区分是哪次请求的业务。 |
brand_code | 1 | String | 数字,最大32位 | 品牌编号,系统对接前由"收钱吧"分配并提供 |
store_sn | 1 | String | 字符串,最大36位 | 商户内部使用的门店编号 |
store_name | 0-1 | String | 字符串,最大255位 | 商户门店名称 |
workstation_sn | 1 | String | 字符串,最大36位 | 门店收银机编号,如果没有请传入"0" |
check_sn | 1 | String | 字符串,最大32位 | 商户订单号 |
sales_sn | 0-1 | String | 字符串,最大36位 | POS 或 电商等业务系统内的实际销售订单号,不同于check_sn。如果发起支付请求时该订单号已经生成,强烈建议传入,方便后续对账和运营流程使用。本字段不影响交易本身。 |
sales_time | 1 | String | 字符串,20- 25位 | 商户订单创建时间, 格式详见 1.5时间数据元素定义 |
channel_fixed | 0-1 | String | 数字,1位 | 是否指定预授权渠道,0,不指定;1,指定。 默认为0 |
auth_channel | 0-1 | String | 数字,1位 | 预授权渠道,1:银行卡,2:微信,3:支付宝,4:微信支付分。 不指定预授权渠道该字段无效,指定预授权渠道后必传。 |
contract_sn | 0-1 | String | 字符串,最大128位 | 收钱吧签约协议号,auth_channel=4时启用该字段,签约成功时获取。 不填写为需确认模式;填写为免确认模式。根据业务需要填写。 |
credit_template_sn | 0-1 | String | 字符串,最大32位 | 收钱吧信用模版编号,auth_channel=4时启用该字段。选填,不填则用默认模版编号。 |
amount | 1 | String | 数字,最大12位 | 预授权金额,精确到分 |
currency | 1 | String | 字符串,3位 | 币种,ISO numeric currency code 如:"156"for CNY |
subject | 1 | String | 字符串,最大64位 | 订单简短描述,建议传8个字内 |
description | 0-1 | String | 字符串,最大255位 | 订单描述 |
operator | 1 | String | 字符串,最大32位 | 操作员,可以传入收款的收银员或导购员。例如"张三" |
customer | 0-1 | String | 字符串,最大32位 | 可以传入需要备注顾客的信息 |
extension_1 | 0-1 | String | 字符串,最大32位 | 拓展字段1,可以用于做自定义标识,如座号,房间号; 智能终端手动录单功能需要添加此字段请联系收钱吧技术支持 |
extension_2 | 0-1 | String | 字符串,最大32位 | 拓展字段1,可以用于做自定义标识,如座号,房间号; 智能终端手动录单功能需要添加此字段请联系收钱吧技术支持 |
industry_code | 1 | String | 数字,1位 | 行业代码, 0=零售;1:酒店; 2:餐饮; 3:文娱; 4:教育; |
pos_info | 1 | String | 字符串,最大64位 | 传入商户系统的产品名称、系统编号等信息,便于帮助商户调查问题 |
notify_url | 0-1 | String | 字符串,最大255位 | 通知接收地址。总共回调7次,回调时间间隔:4m,10m,10m,1h,2h,6h,15h。 |
reflect | 0-1 | String | 字符串,最大255位 | 反射参数; 任何开发者希望原样返回的信息,可以用于关联商户ERP系统的订单或记录附加订单内容。 |
返回参数:
参数 | 出现 | 类型 | 约束 | 描述 |
---|---|---|---|---|
brand_code | 1 | String | 数字,最大32位 | 品牌编号,系统对接前由"收钱吧"分配并提供,返回调用方传入的值 |
store_sn | 1 | String | 字符串,最大36位 | 商户内部使用的门店编号,返回调用方传入的值 |
workstation_sn | 1 | String | 字符串,最大36位 | 门店收银机编号,返回调用方传入的值 |
check_sn | 1 | String | 字符串,最大32位 | 商户订单号,返回调用方传入的值 |
order_sn | 1 | String | 字符串,最大32位 | 本系统为该订单生成的订单序列号 |
sales_sn | 0-1 | String | 字符串,最大36位 | POS 或 电商等业务系统内的实际销售订单号,不同于check_sn。如果发起支付请求时该订单号已经生成,强烈建议传入,方便后续对账和运营流程使用。本字段不影响交易本身。 |
order_source | 1 | String | 数字,1 位 | 订单来源:1=商户系统,3=智能终端,4=门店码牌 |
reflect | 0-1 | String | 字符串,最大255位 | 反射参数; 任何开发者希望原样返回的信息,可以用于关联商户ERP系统的订单或记录附加订单内容。可以在订单结果通知中返回 |
pay_request_param | 0-1 | JSON | JSON对象 | 支付通道返回的调用微信《调起支付分-确认订单》方法所需的参数,微信支付分需确认模式下返回 |
pay_request_param
参数 | 出现 | 类型 | 约束 | 描述 |
---|---|---|---|---|
mch_id | 0-1 | String | 字符串,最大32位 | 微信支付分配置的商户号 |
package | 0-1 | String | 字符串,最大128位 | 前端调用《调起支付分-确认订单》方法所需的重要参数 |
timestamp | 0-1 | String | 字符串,最大32位 | 生成签名时间戳,单位秒 |
nonce_str | 0-1 | String | 字符串,最大32位 | 生成签名随机串。由数字、大小写字母组成,长度不超过32位 |
sign_type | 0-1 | String | 字符串,最大32位 | 签名类型,仅支持HMAC-SHA256 |
sign | 0-1 | String | 字符串,最大64位 | 使用字段mch_id、package、timestamp、nonce_str、sign_type按照微信官方签名生成算法计算得出的签名值 |
前端调用方法地址(以业务为小程序场景为例):https://pay.weixin.qq.com/wiki/doc/apiv3_partner/Offline/apis/chapter6_2_29.shtml