授权类结果通知

API endpoint: 由商户提供,收钱吧配置

Verb: POST

Signature :请求参数中包含签名,商家需要对签名进行验签,参考统一签名说明

请求参数:

参数 出现 类型 约束 描述
notification_sn 1 String 字符串,最大32位 通知编号
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:操作完成
sales_time 1 String 字符串,20- 25位 订单创建时间, 格式详见 1.5时间数据元素定义
auth_channel 1 String 数字,1位 预授权渠道,1:银行卡,2.微信,3.支付宝
amount 1 String 数字,最大12位 预授权金额,精确到分
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。
reflect 0-1 String 字符串,最大255位 反射参数; 任何开发者希望原样返回的信息,可以用于关联商户ERP系统的订单或记录附加订单内容。可以在订单结果通知中返回
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
银行卡支付:交易返回的交易授权码

商户收到通知后的响应,收钱吧判断通知成功的标志,参考响应通用定义。示例:

{
    "response":{
        "head":{
            "version":"1.0.0",
            "sign_type":"SHA256",
            "appid":"28lp61847655",
            "response_time":"2019-08-01T12:00:00+08:00"
        },
        "body":{
            "result_code":"200",
            "biz_response":{
                "result_code":"200"
            }
        }
    },
    "signature":"签名值"
}

results matching ""

    No results matching ""