1.7.1业务功能
当交易发生之后一段时间内,由于买家或者卖家的原因需要退款时,卖家可以通过退款接口将支付款退还给买家,小象支付将在收到退款请求并且验证成功之后,按照退款规则将支付款按原路退到买家帐号上。
1.微信交易时间超过一年的订单无法提交退款,支付宝交易时间超过半年的订单无法提交退款。根据用户支付时使用的支付方式(借记卡,贷记卡,第三方钱包余额等),退款到账时间会不同,具体到账时间由各第三方或银行决定;
2、退款仅支持单笔交易单次全额退款,退款需要提交原支付订单的商户订单号。总退款金额不能超过用户实际支付金额。 同一笔退款失败后重新提交,请不要更换退款单号,请使用原商户退款单号。
1.7.2请求参数
接口地址:BASEURL+/online/payEntry.do
字段名 | 变量名 | 必填 | 类型 | 中文释义 |
商户号 | merid | 是 | String(18) | 商户号,由小象支付分配的18位商户号 |
商户退款订单 | refundorderid | 否 | String(32) | 商户发起退款的订单号 |
商户原交易订单号 | orderid | 否 | String(32) | 商户系统内部订单号,不可和outtradeno同时为空 |
小象支付原交易订单号 | outtradeno | 否 | String(32) | 小象支付系统交易流水号,不可和orderid同时为空 |
支付方式 | paymethod | 是 | String(10) | 微信:wx支付宝:zfb百度钱包:bfbQQ钱包:qq京东钱包:jd |
支付方法 | funname | 是 | String(20) | 默认:refund |
退款金额 | refundamount | 是 | String(12) | 退款金额,小于或等于原订单交易金额 |
支付宝2.0默认参数 | zfbtwo | 否 | String(6) | 默认:zfbtwo支付宝2.0必填,其他支付方式不填。 |
异步通知地址 | notifyurl | 否 | String(200) | 订单支付退款成功之后,祥付宝会向此地址发送异步通知,详情参考1.11 |
小象支付门店编号 | storecode | 否 | String(32) | 一个商户可以有多个门店,如果不传默认交易进入总店;如果传了门店号,交易则进入对应的门店下。 |
签名 | sign | 是 | String(32) | 生成方法见1.2 |
1.7.3返回参数
字段名 | 变量名 | 必填 | 类型 | 中文释义 |
响应码 | flag | 是 | String(6) | 小象支付接口响应码,00表示退款请求提交成功 |
响应内容 | msg | 是 | String(50) | 小象支付接口对响应码的解释 |