其他功能

线下 pos 异步通知

功能说明

用于提供给商户线下 pos 交易结果异步通知

调用方式:系统调用

异步返回参数

参数中文名称 参数名称 数据格式 是否必须 说明
网关返回码 resp_code 定长5位String 网关返回码
网关返回描述 resp_desc 变长512位String 网关返回描述
交易响应内容体 resp_data 变长String 返回参数

内容体(resp_data)

参数中文名称 参数名称 数据格式 是否必须 说明
业务返回码 sub_resp_code 定长8位String 业务返回码
业务返回描述 sub_resp_desc 变长512位String 业务返回描述
请求流水号 req_seq_id 变长32位String 交易时传入,原样返回
请求时间 req_date 定长8位String 交易时传入,原样返回
商户订单号 mer_ord_id 变长128位String 商户生成
客户号 huifu_id 变长22位String  
商户名称 mer_name 变长100位String  
渠道商Id bagent_id 变长32位String  
渠道商名称 bagent_name 变长100位String  
交易类型 trans_type 变长20位String 详见数据字典
全局流水号 hf_seq_id 变长40位String  
微信返回的响应报文 wx_response jsonObject Json格式
支付宝返回的响应报文 alipay_response jsonObject Json格式
银联返回的响应报文 unionpay_response jsonObject Json格式
交易金额 trans_amt 变长12位String 交易金额,统一微信、支付宝、银联总金额
结算金额 settlement_amt 变长16位String 结算金额,单位为元
手续费金额 fee_amount 变长16位String 手续费金额,单位为元
分账串 acct_split_bunch json object 4000位,见4.分账说明
是否延时交易 is_delay_acct 定长1位String 1:延时交易 ; 0:非延时交易;
是否分账交易 is_div 定长1位String 1:分账交易 ; 0:非分账交易;
手续费扣款标志 fee_flag int 1-外扣 2-内扣
通知类型 notify_type int 1:通道通知,2:账务通知
账务日期 acct_date 定长8位String ACCT账务日期,yyyyMMdd
交易状态 trans_stat 定长1位String P:处理中,S:成功,F:失败
账务状态 acct_stat 定长1位String P:处理中,S:成功,F:失败
通道返回码 bank_code 变长32位String  
通道返回描述 bank_message 变长200位String  
微信支付宝订单号 out_trans_id 变长64位String  
支付凭证号 party_order_id 变长64位String  
支付完成时间 end_time 定长14位String  
借贷标识 debit_flag 定长1位String 1-借,2-贷,3-其他(目前只有民生通道返回) D-借记卡,C-贷记卡,S:准贷记卡,P:预付费卡,O-其他
交易时间 trans_time 定长14位String 支付完成时间,格式为yyyyMMddHHmmss
外部订单号 out_ord_id 变长50位String  
汇付终端号 devs_id 变长32位String  
凭证号 posp_seq_id 变长6位String  
备注 remark 变长45位String  
商户私有域 mer_priv 变长1024位String 原样返回
核销金额 mypaytsf_discount 变长12位String 发生核销业务时返回核销金额,否则为0
授权码 auth_no 变长64位String  
补贴状态 subsidy_stat 定长1位String P:处理中,S:成功,F:失败
补贴转账详情 subsidy_transfer_detail TransferDetail列表 补贴转账详情
秒转详情 ts_transfer_detail TransferDetail列表 秒转详情

微信返回的响应报文(wx_response)

参数中文名称 参数名称 数据格式 是否必须 说明
子商户公众账号ID sub_appid 变长32位String 微信分配的子商户公众账号ID
用户标识 openid 变长128位String 用户在商户appid下的唯一标识
用户子标识 sub_openid 变长128位String 用户在子商户appid下的唯一标识
付款银行 bank_type 变长16位String 银行类型,采用字符串类型的银行标识,银行类型见附表
现金支付金额 cash_fee int 现金支付金额订单现金支付金额
代金券金额 coupon_fee String 代金券或立减优惠金额<=订单总金额,订单总金额-代金券或立减优惠金额=现金支付金额
商家数据包 attach 变长128位String 商家数据包,原样返回
营销详情列表 promotion_detail 变长6000位String 营销详情列表,使返回值为JSONArray格式 上传version时有此字段

营销详情列表(promotion_detail)

参数中文名称 参数名称 数据格式 是否必须 说明
券或者立减优惠id promotion_id 变长32位String 券或者立减优惠id
优惠名称 name 变长64位String 优惠名称
优惠范围 scope 变长32位String GLOBAL- 全场代金券 SINGLE- 单品优惠
优惠类型 type 变长32位String COUPON- 代金券,需要走结算资金的充值型代金券,(境外商户券币种与支付币种一致) DISCOUNT- 优惠券,不走结算资金的免充值型优惠券,(境外商户券币种与标价币种一致
优惠券面额 amount 变长5位String 用户享受优惠的金额
活动ID activity_id 变长32位String 在微信商户后台配置的批次ID
商户出资 merchant_contribute 变长32位String 特指商户自己创建的优惠,出资金额等于本项优惠总金额,单位为元
其他出资 other_contribute 变长32位String 其他出资方出资金额,单位为元
单品列表 goods_detail 变长3000位String 单品信息,使用Json格式,是promotion_detail的元素

单品列表(goods_detail)

参数名称 数据格式 是否必须 说明
goods_id 变长32位String 由半角的大小写字母、数字、中划线、下划线中的一种或几种组成
goods_remark 变长32位String goods_remark为备注字段,按照配置原样返回,字段内容在微信后台配置券时进行设置
discount_amount 变长32位String 单品的总优惠金额,单位为:元
quantity 变长32位String 用户购买的数量
price 变长32位String 单位为:元。如果商户有优惠,需传输商户优惠后的单价(例如:用户对一笔100元的订单使用了商场发的纸质优惠券100-50,则活动商品的单价应为原单价-50)

支付宝返回的响应报文(alipay_response)

参数中文名称 参数名称 数据格式 是否必须 说明
本交易支付时使用的所有优惠券信息 voucher_detail_list 变长String 本交易支付时使用的所有优惠券信息
支付金额信息 fund_bill_list 变长512位String 支付成功的各个渠道金额信息,详见资金明细信息说明
买家的支付宝唯一用户号 buyer_id 变长100位String 买家的支付宝唯一用户号(2088开头的16位纯数字)
买家支付宝账号 buyer_logon_id 变长100位String 买家支付宝账号
花呗分期数 hb_fq_num 变长2位String 花呗分期数
卖家承担的手续费 hb_fq_seller_percent 变长3位String 卖家承担的手续费

优惠券信息 (voucher_detail_list)

参数中文名称 参数名称 数据格式 是否必须 说明
券id id 变长32位String 券id
券名称 name 变长32位String 券名称
券类型 type 变长32位String 当前有三种类型: ALIPAY_FIX_VOUCHER - 全场代金券 ALIPAY_DISCOUNT_VOUCHER - 折扣券 ALIPAY_ITEM_VOUCHER - 单品优惠 注:不排除将来新增其他类型的可能,商家接入时注意兼容性避免硬编码
优惠券面额 amount BigDecimal(8,2) 优惠券面额,它应该会等于商家出资加上其他出资方出资
商家出资(特指发起交易的商家出资金额) merchant_contribute BigDecimal(8,2) 商家出资(特指发起交易的商家出资金额)
其他出资方出资金额 other_contribute 变长11位String 其他出资方出资金额,可能是支付宝,可能是品牌商,或者其他方, 也可能是他们的一起出资

支付金额信息(fund_bill_list)

参数中文名称 参数名称 数据格式 是否必须 说明
银行卡支付时的银行代码 bank_code 变长10位String 银行卡支付时的银行代码

分账串(acct_split_bunch)

参数中文名称 参数名称 数据格式 是否必须 说明
手续费客户号 fee_huifu_id 变长16位String  
手续费账户号 fee_acct_id 变长9位String  
手续费金额 fee_amt 变长12位String 若未填手续费金额,则根据配置的手续费公式计算手续费。
手续费账务日期 fee_acct_date 变长8位String YYYYMMDD
分账明细 acct_infos 变长String  

分账明细(acct_infos)

参数中文名称 参数名称 数据格式 是否必须 说明
分账金额 div_amt 变长12位String 单位元,需保留小数点后两位,例如:1.00
客户号 huifu_id 变长16位String  
账户号 acct_id 变长9位String  
账务日期 acct_date 定长9位String  

返回码

网关返回码

返回码 返回描述
10000 成功调用
20000 服务不可用请联系客服
20001 权限不足
40001 无效参数
40002 验签失败

业务返回码

返回码 返回描述
20000 服务不可用请联系客服
20001 权限不足
40001 无效参数
40002 验签失败
00000000 交易成功
00000100 交易正在处理中
10000000 无效参数
10000001 原交易没有处理完成
10000002 退款金额大于可退金额
10000003 退款金额大于待确认金额
10000004 手续费退款金额大于可退金额
10000005 银联聚合补账不允许退款
10000006 必须传入分账串
10000007 该退款不支持传入分账
10000008 退款分账金额不能大于可退分账金额
10000009 该交易不支持部分退款
10000010 含有未知的子客户号
10000011 手续费子客户和原交易的不一致
10000012 优惠交易传入的分账金额总和不等于结算金额
10000013 分账金额总和不等于退款订单金额
10000014 数据库更新失败
10000015 不允许关闭一分钟以内的订单
10000016 原订单已为终态,请发起查询交易获取
10000017 该交易暂不支持银联二维码
10000018 关单失败
10000019 手续费子客户和原交易的不一致
10000020 没有退款权限
10000021 没有分账退款权限
10000022 退款分账不能为空
20000000 重复交易
20000002 权限不足
20000003 账户已被冻结
20000004 交易不存在
20000005 商户不存在
20000006 商户状态异常
20000007 结算卡不存在
20000008 账户信息不存在
20000009 手续费账户信息不存在
20000010 SSP子客户号和账户号无效
20000011 手续费未配置
20000012 分账金额不等于订单总金额
20000013 交易未完全成功
20000014 已无可确认金额
20000015 确认参数或确认手续费承担方式与原交易冲突
20000016 原交易发起方与此交易不一致
20000017 交易非延迟入账
30000000 调用收银台退款接口失败
30000001 收银台校验失败
90000000 交易失败,请重试
90000001 交易存在风险,请稍后再试
90000002 风控拦截
99999999 系统异常,请稍后重试