CloudPay.refund() |
您所在的位置:网站首页 › 微信小程序下单退款 › CloudPay.refund() |
# CloudPay.refund() 支持端:云函数 2.0.2 申请退款 # 说明当交易发生之后一段时间内,由于买家或者卖家的原因需要退款时,卖家可以通过退款接口将支付款退还给买家,微信支付将在收到退款请求并且验证成功之后,按照退款规则将支付款按原路退到买家账号上。 注意: 1.交易时间超过一年的订单无法提交退款; 2、微信支付退款支持单笔交易分多次退款,多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。 一笔退款失败后重新提交,请不要更换退款单号,请使用原商户退款单号。 3、请求频率限制:150qps,即每秒钟正常的申请退款请求次数不超过150次。错误或无效请求频率限制:6qps,即每秒钟异常或错误的退款申请请求不超过6次 4、每个支付订单的部分退款次数不能超过50次 此接口与微信支付原接口(文档)的不同点在于: 私有安全链路,免证书管理,免签名计算 商户号填入 sub_mch_id 字段,小程序/公众号 appid 填入 sub_appid 字段 免填写以下字段:mch_id、appid、sign、sign_type 接口入参和返回值都为 JSON 而不是 XML # 关键参数说明云开发相关关键参数说明: 回调函数设置:envId 和 functionName 用来设置接收支付后的异步通知回调的云函数 返回字段 payment:该对象即是在小程序端调用 wx.requestPayment 所需的信息 # 接收支付结果回调的云函数的入参和返回协议详见支付结果回调云函数协议。 # 参数说明 字段名 变量名 必填 类型 示例值 描述 结果通知回调云函数名 functionName 是 String paycallback 接收微信支付异步通知回调的云函数名 结果通知回调云函数环境 envId 是 String test-123 接收微信支付异步通知回调的云函数所在的环境 ID 子商户号 sub_mch_id 是 String(32) 1900000109 微信支付分配的子商户号 随机字符串 nonce_str 是 String(32) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS 随机字符串,不长于32位。推荐随机数生成算法 微信订单号 transaction_id 否 String(32) 1217752501201407033233368018 微信订单号。与商户订单号二选一填入。 商户订单号 out_trade_no 否 String(32) 1217752501201407033233368018 商户系统内部订单号,要求32个字符内,只能是数字、大小写字母_- 商户退款单号 out_refund_no 是 String(64) 1.21775E+27 商户系统内部的退款单号,商户系统内部唯一,只能是数字、大小写字母_- 订单金额 total_fee 是 Int 100 订单总金额,单位为分,只能为整数,详见支付金额 申请退款金额 refund_fee 是 Int 100 退款总金额,单位为分,只能为整数,可部分退款。详见支付金额 货币种类 refund_fee_type 否 String(8) CNY 货币类型,符合ISO 4217标准的三位字母代码,默认人民币:CNY,其他值列表详见货币类型 退款原因 refund_desc 否 String(80) 商品已售完 若商户传入,会在下发给用户的退款消息中体现退款原因注意:若订单退款金额≤1元,且属于部分退款,则不会在退款消息中体现退款原因 退款资金来源 refund_account 否 String(30) REFUND_SOURCE_RECHARGE_FUNDS 仅针对老资金流商户使用REFUND_SOURCE_UNSETTLED_FUNDS---未结算资金退款(默认使用未结算资金退款)REFUND_SOURCE_RECHARGE_FUNDS---可用余额退款# 返回值说明 字段名 变量名 必填 类型 示例值 描述 返回状态码 returnCode 是 String(16) SUCCESS SUCCESS/FAIL 返回信息 returnMsg 否 String(128) 签名失败 返回信息,如非空,为错误原因。如 签名失败、参数格式校验错误以下字段在returnCode为SUCCESS的时候有返回 字段名 变量名 必填 类型 示例值 描述 业务结果 result_code 是 String(16) SUCCESS SUCCESS/FAILSUCCESS退款申请接收成功,结果通过退款查询接口查询FAIL 提交业务失败 错误代码 err_code 否 String(32) SYSTEMERROR 列表详见错误码列表 错误代码描述 err_code_des 否 String(128) 系统超时 结果信息描述 服务商的APPID appid 是 String(32) wxd678efh567hg6787 服务商商户的APPID 商户号 mch_id 是 String(32) 1230000109 微信支付分配的商户号 小程序的APPID sub_appid 是 String(32) wx8888888888888888 微信分配的小程序ID 子商户号 sub_mch_id 是 String(32) 1900000109 微信支付分配的子商户号 随机字符串 nonce_str 是 String(32) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS 随机字符串,不长于32位 签名 sign 是 String(32) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS 签名,详见签名算法 微信订单号 transaction_id 是 String(32) 1217752501201407033233368018 微信订单号 商户订单号 out_trade_no 是 String(32) 1217752501201407033233368018 商户系统内部订单号,要求32个字符内,只能是数字、大小写字母_- 商户退款单号 out_refund_no 是 String(64) 1217752501201407033233368018 商户系统内部的退款单号,商户系统内部唯一,只能是数字、大小写字母_- 微信退款单号 refund_id 是 String(32) 1217752501201407033233368018 微信退款单号 申请退款金额 refund_fee 是 Int 100 退款总金额,单位为分,可以做部分退款 退款金额 settlement_refund_fee 否 Int 100 去掉非充值代金券退款金额后的退款金额,退款金额=申请退款金额-非充值代金券退款金额,退款金额 |
今日新闻 |
点击排行 |
|
推荐新闻 |
图片新闻 |
|
专题文章 |
CopyRight 2018-2019 实验室设备网 版权所有 win10的实时保护怎么永久关闭 |