授权类结果通知
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":"签名值"
}