授权类结果查询
API endpoint: {api_domain}/api/lite-pos/v1/authorization/query
Verb: POST
Signature :需要签名,参考统一签名说明
请求参数:
参数 | 出现 | 类型 | 约束 | 描述 |
---|---|---|---|---|
brand_code | 1 | String | 数字,最大32位 | 品牌编号,系统对接前由"收钱吧"分配并提供 |
store_sn | 1 | String | 字符串,最大36位 | 商户内部使用的门店编号 |
workstation_sn | 1 | String | 字符串,最大36位 | 门店收银机编号,如果没有请传入"0" |
check_sn | 1 | String | 字符串,最大32位 | 商户订单号,在商户系统中唯一 |
order_sn | 0-1 | String | 字符串,最大32位 | 预授权订单下发时收钱吧返回的订单号(可选,优先使用order_sn作查询) |
返回参数:
参数 | 出现 | 类型 | 约束 | 描述 |
---|---|---|---|---|
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位 | 订单序列号 |
order_type | 1 | String | 数字,1位 | 订单类型,3 预授权;4 预授权撤销; |
sales_sn | 0-1 | String | 字符串,最大36位 | POS 或 电商等业务系统内的实际销售订单号,不同于check_sn。如果发起支付请求时该订单号已经生成,强烈建议传入,方便后续对账和运营流程使用。本字段不影响交易本身。 |
order_source | 1 | String | 数字,1 位 | 订单来源:1=商户系统,3=智能终端,4=门店码牌,5=商户后台 |
order_status | 1 | String | 数字,1位 | 订单状态0:已取消,1:待操作,3:等待结果中,4:操作完成,6:操作失败 |
sales_time | 1 | String | 字符串,20- 25位 | 订单创建时间, 格式详见 1.5时间数据元素定义 |
amount | 1 | String | 数字,最大12位 | 订单总金额,精确到分。 |
channel_fixed | 0-1 | String | 数字,1位 | 是否指定预授权渠道,0,不指定,1,指定,默认为0 |
auth_channel | 1 | String | 数字,1位 | 预授权渠道,1:银行卡,2:微信,3:支付宝,4:微信支付分 |
currency | 1 | String | 字符串,3位 | 币种,ISO numeric currency code 如:"156"for CNY |
subject | 1 | String | 字符串,最大64位 | 订单简短描述 |
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 |
tenders | 0-n | [tender] | tender数组 | 预授权/预授权撤销操作流水结果信息,定义如下表 |
tenders:
参数 | 出现 | 类型 | 约束 | 描述 |
---|---|---|---|---|
amount | 1 | String | 数字,最大12位 | 预授权/预授权撤销金额,精确到分 |
tender_sn | 0-1 | String | 字符串,最大32位 | 预授权/预授权撤销操作成功后本系统返回的流水号 |
pay_time | 0-1 | String | 字符串,20- 25位 | 操作成功时间, 格式详见 1.5时间数据元素定义 |
pay_status | 1 | Int | 数字,1位 | 预授权/预授权撤销状态, 1:成功;2:失败; |
channel_sn | 0-1 | String | 字符串,最大 | 渠道流水号,操作成功时存在; 微信支付宝:微信支付宝流水号; 银行卡:银行卡系统参考号。 |
internal_transaction_sn | 0-1 | String | 字符串,最大 | 移动支付:收钱吧传入支付宝/微信的out_trade_no 银行卡支付:交易返回的交易授权码 |