异步返回参数
| 参数中文名称 |
参数名称 |
数据格式 |
是否必须 |
说明 |
| 网关返回码 |
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 |
否 |
|