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