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

Size: px

Start display at page:

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

堂尹
5 years ago
Views:

1 开通免充值业务功能 API 接口升级详情开通免充值业务功能后, 以下 6 个支付业务接口部分参数将会按照以下表格变更, 请确认是否优先进行内部系统升级以适配新的接口参数 (api 接口中, 只有使用了免充值券才会返回新增参数 ) 一接口变更概览 : 编号接口名称新增修改删除修改参数名称 : 1 下载对账单新增返回字段 : 1 订单金额 2 申请退款金额 3 费率备注 4 订单总金额 5 申请退款总金额总金额更改为应结订单金额总交易额更改为应结订单总金额总退款金额更改为退款总金额企业红包金额更改为代金券金额企业红包退款金额更改为充值券退款金额总企业红包退款金额更改为充值券退款总金额新增返回参数 : 2 刷卡支付 1 settlement_total_fee ( 应结订单金额 ) 新增返回参数 : 3 订单查询 1 settlement_total_fee ( 应结订单金额 ) 2 coupon_type( 代金券类型 ) 新增返回参数 : 1 settlement_refund_fee( 应结 4 申请退款退款金额 ) 2 settlement_total_fee( 应结订单金额 ) 3 coupon_type( 代金券类型 ) 新增返回参数 : 1 settlement_refund_fee( 应结 5 查询退款退款金额 ) 2 settlement_total_fee( 应结订单金额 ) 3 coupon_type( 代金券类型 )

2 新增返回参数 : 6 支付通知 1 settlement_total_fee( 应结订单金额 ) 2 coupon_type( 代金券类型 ) 二接口变更详情 1.1 下载对账单变更详情微信支付新账单格式说明原账单新账单备注说明交易时间公众账号 ID 商户号特约商户号设备号微信订单号商户订单号用户标识交易类型交易状态付款银行货币种类退款类型退款状态商品名称商户数据包手续费费率微信退款单号商户退款单号总金额企业红包金额更改为 : 应结订单金额更改为 : 代金券金额每一笔交易订单中参与结算 ( 未扣除手续费 ) 的总金额, 即包括用户使用微信支付零钱或者银行卡快捷方式支付的金额, 加上本订单中使用的预充值优惠之和, 并不涵盖本订单中使用的免充值优惠该字段描述了每一笔交易订单中使用的优惠金额 ( 包含免充值优惠金额 + 预充值优惠金额 )

3 退款金额描述了针对该笔订单中申请退款后实际退款的金额 1 如未使用免充值优惠: 退款金额 = 申请退款金额 ; 2 如果使用了免充值优惠 : 根据用户使用的免充值优惠, 在订单金额中的占比进行扣除后, 进行退款, 即退款金额 < 申请退款金额企业红包退款金额更改为 : 充值券退款金额指预充值优惠的退款金额 ( 不包含免充值优惠退款金额 ) 新增 : 订单金额新增 : 申请退款金额新增 : 费率备注每一笔交易订单的整单金额如未使用免充值优惠, 本项金额等于应结订单金额发起退款时提交的退款金额 (refund_fee) 在没有使用免充值优惠的情况下, 本项金额等于退款金额对费率计算方法的解释说明总交易单数总交易额更改为 : 应结订单总金额对应结订单金额的汇总总退款金额更改为 : 退款总金额对退款金额的汇总总企业红包退款金额更改为 : 充值券退款总金额对充值券退款金额 " 的汇总手续费总金额新增 : 订单总金额对订单金额的汇总新增 : 申请退款总金额对 " 申请退款金额的汇总 " 备注 : 1 预充值优惠 : 指配置代金券立减折扣等优惠时, 营销经费来源选择了预充值, 使用本商户号余额 2 免充值优惠 : 指配置代金券立减折扣等优惠时, 营销经费来源选择了免充值, 优惠核销时扣减订单实收金额 1.2 刷卡支付变更详情刷卡支付接口变更对照表 ( ) 接口名称 : 接口请求地址 : 刷卡支付入参参数名称变量名称变更情况描述公众账号 ID appid 商户号 mch_id 子商户公众账号 ID sub_appid 子商户号 sub_mch_id 随机字符串 nonce_str 签名 sign 商品描述 body 商户订单号 out_trade_no 标价金额 total_fee 标价币种 fee_type 授权码 auth_code

4 设备号 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 订单查询接口变更详情订单查询接口变更对照表 ( ) 接口名称 : 接口请求地址 : 订单查询入参参数名称变量名称变更情况描述公众账号 ID appid 商户号 mch_id 子商户公众账号 ID sub_appid

5 子商户号 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 申请退款接口变更详情申请退款接口变更对照表 ( )

6 接口名称 : 接口请求地址 : 申请退款入参参数名称变量名称变更情况描述公众账号 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

7 退款渠道 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 退款查询接口变更详情退款查询接口变更对照表 ( ) 接口名称 : 接口请求地址 : 退款查询入参参数名称变量名称变更情况描述公众账号 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

8 随机字符串 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( 应结退款金额 - 订单使用了免充值应结退款金额 settlement_refund_fee_$n 新增券才返回, 应结退款金额 = 订单总退款金额 - 免充值券退款金额, 即实际退款的金额 ) settlement_total_fee( 应结订单金额 - 订单使用了免充值券应结订单金额 settlement_total_fee_$n 新增代金券类型 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

9 签名 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( 应结订单金额 - 订单使用了免充值券才返回, 应结订单金额 = 订单总金额 - 免充值券金额, 即实际结算金额 )

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

【普通商户】开通免充值业务功能API接口升级详情开通免充值业务功能 API 接口升级详情开通免充值业务功能后, 以下 6 个支付业务接口部分参数将会按照以下表格变更, 请确认是否优先进行内部系统升级以适配新的接口参数 (api 接口中, 只有使用了免充值券才会返回新增参数 ) 一接口变更概览 : 编号新增修改删除修改参数名称 : 1 下载对账单新增返回字段 : 1 订单金额 2 申请退款金额 3 费率备注 4 订单总金额 5 申请退款总金额