预授权

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

results matching ""

    No results matching ""