【服务商商户】开通免充值业务功能API 接口升级详情

2020-04-24 18:48:20 0
文件版本 :
立即下载

【服务商商户】开通免充值业务功能API 接口升级详情

开通免充值业务功能后,以下6 个支付业务接口部分参数将会按照以下表格变更,请确认是否优先进行内部系

统升级以适配新的接口参数(api 接口中,只有使用了免充值券才会返回新增参数)

一、接口变更概览:

编号接口名称新增修改删除

1 下载对账单

新增返回字段:

1、订单金额

2、申请退款金额

3、费率备注

4、订单总金额

5、申请退款总金额

修改参数名称:

“总金额” 更改为“应结订单金额”

“总交易额” 更改为“应结订单总金额”

“总退款金额” 更改为“退款总金额”

“企业红包金额” 更改为“代金券金额”

“企业红包退款金额” 更改为“充值券

退款金额”

“总企业红包退款金额” 更改为“充值

券退款总金额”

2 刷卡支付

新增返回参数:

1、settlement_total_fee (应结订

单金额)

无无

3 订单查询

新增返回参数:

1、settlement_total_fee (应结订

单金额)

2、coupon_type(代金券类型)

无无

4 申请退款

新增返回参数:

1、settlement_refund_fee(应结

退款金额)

2、settlement_total_fee(应结订

单金额)

3、coupon_type(代金券类型)

无无

5 查询退款

新增返回参数:

1、settlement_refund_fee(应结

退款金额)

2、settlement_total_fee(应结订

单金额)

3、coupon_type(代金券类型)

无无

6 支付通知

新增返回参数:

1、settlement_total_fee(应结订

单金额)

2、coupon_type(代金券类型)

无无

二、接口变更详情

1.1 下载对账单变更详情

微信支付新账单格式说明

原账单新账单备注说明

交易时间不变

公众账号ID 不变

商户号不变

特约商户号不变

设备号不变

微信订单号不变

商户订单号不变

用户标识不变

交易类型不变

交易状态不变

付款银行不变

货币种类不变

退款类型不变

退款状态不变

商品名称不变

商户数据包不变

手续费不变

费率不变

微信退款单号不变

商户退款单号不变

总金额更改为:应结订单金额

每一笔交易订单中参与结算(未扣除手续费)的总金额,即包括用户使用微信

支付零钱或者银行卡快捷方式支付的金额,加上本订单中使用的预充值优惠之

和,并不涵盖本订单中使用的免充值优惠。

企业红包金额更改为:代金券金额

该字段描述了每一笔交易订单中使用的优惠金额(包含免充值优惠金额+预充

值优惠金额)

退款金额不变

描述了针对该笔订单中申请退款后实际退款的金额。

1、如未使用免充值优惠:退款金额=申请退款金额;

2、如果使用了免充值优惠:根据用户使用的免充值优惠,在订单金额中的占比

进行扣除后,进行退款,即“退款金额”<“申请退款金额”

企业红包退款金额更改为:充值券退款金额指预充值优惠的退款金额(不包含免充值优惠退款金额)

新增:订单金额

每一笔交易订单的整单金额。如未使用免充值优惠,本项金额等于应结订单金

新增:申请退款金额

发起退款时提交的退款金额(refund_fee)。在没有使用免充值优惠的情况下,

本项金额等于“退款金额”

新增:费率备注对费率计算方法的解释说明

总交易单数不变

总交易额更改为:应结订单总金额对“应结订单金额”的汇总

总退款金额更改为:退款总金额对“退款金额”的汇总

总企业红包退款金额更改为:充值券退款总金额对“充值券退款金额"的汇总

手续费总金额不变

新增:订单总金额对“订单金额”的汇总

新增:申请退款总金额对"申请退款金额的汇总"

备注:

1、预充值优惠:指配置代金券、立减、折扣等优惠时,营销经费来源选择了“预充值,使用本商户号余额”

2、免充值优惠:指配置代金券、立减、折扣等优惠时,营销经费来源选择了“免充值,优惠核销时扣减订单实收金额”

1.2 刷卡支付变更详情

刷卡支付接口变更对照表(服务商商户)

阅读对象服务商商户

接口名称: 刷卡支付

接口请求地址: https://api.mch.weixin.qq.com/pay/micropay

入参

参数名称变量名称变更情况描述

公众账号ID appid 不变

商户号mch_id 不变

子商户公众账号ID sub_appid 不变

子商户号sub_mch_id 不变

随机字符串nonce_str 不变

签名sign 不变

商品描述body 不变

商户订单号out_trade_no 不变

标价金额total_fee 不变

标价币种fee_type 不变

授权码auth_code 不变

设备号device_info 不变

签名类型sign_type 不变

商品详情detail 不变

终端IP spbill_create_ip 不变

附加数据attach 不变

商品标记goods_tag 不变

出参

参数名称变量名称变更类型描述

公众账号ID appid 不变

商户号mch_id 不变

子商户公众账号ID sub_appid 不变

子商户号sub_mch_id 不变

随机字符串nonce_str 不变

签名sign 不变

业务结果result_code 不变

用户标识openid 不变

是否关注公众账号is_subscribe 不变

交易类型trade_type 不变

付款银行bank_type 不变

标价金额total_fee 不变

标价币种fee_type 不变

用户支付金额cash_fee 不变

用户支付金额币种cash_fee_type 不变

微信支付订单号transaction_id 不变

商户订单号out_trade_no 不变

支付完成时间time_end 不变

设备号device_info 不变

错误代码err_code 不变

错误代码描述err_code_des 不变

商家数据包attach 不变

代金券支付金额coupon_fee 不变

应结订单金额settlement_total_fee 新增settlement_total_fee(应结订单金额-订单使用了免充值券才返回,应结

订单金额=订单总金额-免充值券金额,即实际结算金额)

1.3 订单查询接口变更详情

订单查询接口变更对照表(服务商商户)

阅读对象服务商商户

接口名称: 订单查询

接口请求地址: https://api.mch.weixin.qq.com/pay/orderquery

入参

参数名称变量名称变更情况描述

公众账号ID appid 不变

商户号mch_id 不变

子商户公众账号ID sub_appid 不变

子商户号sub_mch_id 不变

微信订单号transaction_id 不变

商户订单号out_trade_no 不变

签名sign 不变

随机字符串nonce_str 不变

签名类型sign_type 不变

出参

参数名称变量名称变更类型描述

返回状态码return_code 不变

返回信息return_msg 不变

公众账号ID appid 不变

商户号mch_id 不变

子商户公众账号ID sub_appid 不变

子商户号sub_mch_id 不变

随机字符串nonce_str 不变

签名sign 不变

业务结果result_code 不变

用户标识openid 不变

交易类型trade_type 不变

交易状态trade_state 不变

交易状态描述trade_state_desc 不变

付款银行bank_type 不变

标价金额total_fee 不变

标价币种fee_type 不变

用户支付金额cash_fee 不变

用户支付金额币种cash_fee_type 不变

微信支付订单号transaction_id 不变

商户订单号out_trade_no 不变

支付完成时间time_end 不变

设备号device_info 不变

是否关注公众账号is_subscribe 不变

附加数据attach 不变

错误代码err_code 不变

错误代码描述err_code_des 不变

代金券使用数量coupon_count 不变

总代金券金额coupon_fee 不变

单个代金券支付金额coupon_fee_$n 不变

代金券类型coupon_type_$n 新增

coupon_type(代金券类型,取值:CASH--充值代金券,NO_CASH---

免充值券)

代金券ID coupon_id_$n 不变

应结订单金额settlement_total_fee 新增settlement_total_fee(应结订单金额-订单使用了免充值券才返回,应

结订单金额=订单总金额-免充值券金额,即实际结算金额)

1.4 申请退款接口变更详情

申请退款接口变更对照表(服务商商户)

阅读对象服务商商户

接口名称: 申请退款

接口请求地址: https://api.mch.weixin.qq.com/secapi/pay/refund

入参

参数名称变量名称变更情况描述

公众账号ID appid 不变

商户号mch_id 不变

子商户公众账号ID sub_appid 不变

子商户号sub_mch_id 不变

随机字符串nonce_str 不变

签名sign 不变

微信订单号transaction_id 不变

商户订单号out_trade_no 不变

商户退款单号out_refund_no 不变

标价金额total_fee 不变

申请退款金额refund_fee 不变

操作员op_user_id 不变

退款资金来源refund_account 不变

设备号device_info 不变

签名类型sign_type 不变

退款币种refund_fee_type 不变

出参

参数名称变量名称变更类型描述

返回状态码return_code 不变

返回信息return_msg 不变

业务结果result_code 不变

公众账号ID appid 不变

商户号mch_id 不变

子商户公众账号ID sub_appid 不变

子商户号sub_mch_id 不变

随机字符串nonce_str 不变

签名sign 不变

微信订单号transaction_id 不变

商户订单号out_trade_no 不变

商户退款单号out_refund_no 不变

微信退款单号refund_id 不变

退款金额refund_fee 不变

退款币种refund_fee_type 不变

标价金额total_fee 不变

标价币种fee_type 不变

用户支付金额cash_fee 不变

用户支付币种cash_fee_type 不变

用户退款金额cash_refund_fee 不变

错误代码err_code 不变

错误代码描述err_code_des 不变

设备号device_info 不变

退款渠道refund_channel 不变

总退款代金券金额coupon_refund_fee 不变

退款代金券使用数量coupon_refund_count 不变

代金券类型coupon_type_$n 新增

coupon_type(代金券类型,取值:CASH--充值代金券,

NO_CASH---免充值券)

应结退款金额settlement_refund_fee 新增

settlement_refund_fee(应结退款金额-订单使用了免充值

券才返回,应结退款金额=订单总退款金额-免充值券退款金

额,即实际退款的金额)

应结订单金额settlement_total_fee 新增

settlement_total_fee(应结订单金额-订单使用了免充值券

才返回,应结订单金额=订单总金额-免充值券金额,即实际

结算金额)

退款代金券金额coupon_refund_fee_$n 不变

退款代金券ID coupon_refund_id_$n 不变

1.5 退款查询接口变更详情

退款查询接口变更对照表(服务商商户)

阅读对象服务商商户

接口名称: 退款查询

接口请求地址: https://api.mch.weixin.qq.com/pay/refundquery

入参

参数名称变量名称变更情况描述

公众账号ID appid 不变

商户号mch_id 不变

子商户公众账号ID sub_appid 不变

子商户号sub_mch_id 不变

随机字符串nonce_str 不变

签名sign 不变

微信订单号transaction_id 不变

商户订单号out_trade_no 不变

商户退款单号out_refund_no 不变

微信退款单号refund_id 不变

设备号device_info 不变

签名类型sign_type 不变

出参

参数名称变量名称变更类型描述

返回状态码return_code 不变

返回信息return_msg 不变

业务结果result_code 不变

公众账号ID appid 不变

商户号mch_id 不变

子商户公众账号ID sub_appid 不变

子商户号sub_mch_id 不变

随机字符串nonce_str 不变

签名sign 不变

微信订单号transaction_id 不变

商户订单号out_trade_no 不变

标价金额total_fee 不变

标价币种fee_type 不变

用户支付金额cash_fee 不变

用户支付币种cash_fee_type 不变

退款笔数refund_count 不变

退款金额refund_fee_$n 不变

商户退款单号out_refund_no_$n 不变

微信退款单号refund_id_$n 不变

退款状态refund_status_$n 不变

退款入账账户refund_recv_accout_$n 不变

设备号device_info 不变

退款渠道refund_channel_$n 不变

退款资金来源refund_account 不变

错误码err_code 不变

错误描述err_code_des 不变

退款代金券使用数量coupon_refund_count_$n 不变

应结退款金额settlement_refund_fee_$n 新增

settlement_refund_fee(应结退款金额-订单使用了免充值

券才返回,应结退款金额=订单总退款金额-免充值券退款金

额,即实际退款的金额)

应结订单金额settlement_total_fee_$n 新增

settlement_total_fee(应结订单金额-订单使用了免充值券

才返回,应结订单金额=订单总金额-免充值券金额,即实际

结算金额)

代金券类型coupon_type_$n_$m 新增

coupon_type(代金券类型,取值:CASH--充值代金券,

NO_CASH---免充值券)

总退款代金券金额coupon_refund_fee_$n 不变

单个退款代金券金额coupon_refund_fee_$n_$m 不变

退款代金券ID coupon_refund_id_$n_$m 不变

1.6 支付通知接口变更详情

支付通知接口变更对照表(服务商商户)

阅读对象服务商商户

接口名称: 支付通知

返回

参数名称变量名称变更情况描述

返回状态码return_code 不变

返回信息return_msg 不变

公众账号ID appid 不变

商户号mch_id 不变

子商户公众账号ID sub_appid 不变

子商户号sub_mch_id 不变

随机字符串nonce_str 不变

签名sign 不变

业务结果result_code 不变

用户标识openid 不变

交易类型trade_type 不变

付款银行bank_type 不变

标价金额total_fee 不变

标价币种fee_type 不变

用户支付金额cash_fee 不变

用户支付金额币种cash_fee_type 不变

微信支付订单号transaction_id 不变

商户订单号out_trade_no 不变

支付完成时间time_end 不变

设备号device_info 不变

签名类型sign_type 不变

错误代码err_code 不变

错误代码描述err_code_des 不变

是否关注公众账号is_subscribe 不变

商家数据包attach 不变

代金券使用数量coupon_count 不变

代金券金额coupon_fee 不变

单个代金券支付金额coupon_fee_$n 不变

代金券类型coupon_type_$n 新增

coupon_type(代金券类型,取值:CASH--充值代金券,NO_CASH---

免充值券)

代金券ID coupon_id_$n 不变

应结订单金额settlement_total_fee 新增

settlement_total_fee(应结订单金额-订单使用了免充值券才返回,

应结订单金额=订单总金额-免充值券金额,即实际结算金额)