3.2.预授权撤销
API endpoint: {api_domain}/api/lite-pos/v1/authorization/release
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。如果发起支付请求时该订单号已经生成,强烈建议传入,方便后续对账和运营流程使用。本字段不影响交易本身。 |
original_store_sn | 0-1 | String | 字符串,最大36位 | 原始商户门店编号 |
original_workstation_sn | 0-1 | String | 字符串,最大36位 | 原始门店收银机编号,如果没有请传入"0" |
original_check_sn | 0-1 | String | 字符串,最大32位 | 原始商户订单号 |
original_order_sn | 0-1 | String | 字符串,最大32位 | 本系统为该笔预授权撤销对应的原始预授权订单生成的订单序列号 |
sales_time | 1 | String | 字符串,20- 25位 | 订单创建时间, 格式详见1.5时间数据元素定义 |
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系统的订单或记录附加订单内容。 |
original_store_sn+original_workstation_sn+original_check_sn和original_order_sn不能同时为空,优先按original_order_sn查询,如果没有再按original_store_sn+original_workstation_sn+original_check_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位 | 本系统为该订单生成的订单序列号 |
sales_sn | 0-1 | String | 字符串,最大36位 | POS 或 电商等业务系统内的实际销售订单号,不同于check_sn。如果发起支付请求时该订单号已经生成,强烈建议传入,方便后续对账和运营流程使用。本字段不影响交易本身。 |
order_source | 1 | String | 数字,1 位 | 订单来源:1=商户系统,3=智能终端,4=门店码牌 |
reflect | 0-1 | String | 字符串,最大255位 | 反射参数; 任何开发者希望原样返回的信息,可以用于关联商户ERP系统的订单或记录附加订单内容。可以在订单结果通知中返回 |