统一退款

<p><strong>请求URL：</strong></p> <ul> <li><code>/refund/refundOrder</code></li> </ul> <p><strong>请求方式：</strong></p> <ul> <li>POST</li> </ul> <p><strong>请求类型：</strong></p> <ul> <li>application /json</li> </ul> <p><strong>参数：</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">orgId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>服务商id，用于服务商代发起交易，传了此参数需要用服务商秘钥进行加签</td> </tr> <tr> <td style="text-align: left;">mchNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(30)</td> <td>商户号</td> </tr> <tr> <td style="text-align: left;">appId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(24)</td> <td>应用ID，默认为商户appId，若为服务商模式，需传入服务商appId</td> </tr> <tr> <td style="text-align: left;">reqTime</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(13)</td> <td>请求时间，13位时间戳</td> </tr> <tr> <td style="text-align: left;">version</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(3)</td> <td>接口版本，固定：1.0</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(32)</td> <td>签名</td> </tr> <tr> <td style="text-align: left;">signType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(32)</td> <td>签名类型，MD5/RSA/SM2</td> </tr> <tr> <td style="text-align: left;">mchRefundNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(30)</td> <td>商户退款订单号，商户平台唯一</td> </tr> <tr> <td style="text-align: left;">mchOrderNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(30)</td> <td>商户订单号，与payOrderId二者传一即可</td> </tr> <tr> <td style="text-align: left;">payOrderId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(30)</td> <td>支付订单号，与mchOrderNo二者传一即可</td> </tr> <tr> <td style="text-align: left;">refundAmount</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>退款金额，单位分</td> </tr> <tr> <td style="text-align: left;">currency</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(3)</td> <td>货币代码，人民币:cny</td> </tr> <tr> <td style="text-align: left;">orgId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>服务商id，用于服务商代发起退款</td> </tr> <tr> <td style="text-align: left;">refundReason</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(64)</td> <td>退款原因</td> </tr> <tr> <td style="text-align: left;">clientIp</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(32)</td> <td>客户端IP</td> </tr> <tr> <td style="text-align: left;">notifyUrl</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(128)</td> <td>异步通知地址，只有传了该值才会发起回调</td> </tr> <tr> <td style="text-align: left;">channelExtra</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(256)</td> <td>渠道参数，特定渠道发起的额外参数</td> </tr> <tr> <td style="text-align: left;">extParam</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(512)</td> <td>扩展参数，回调时会原样返回</td> </tr> </tbody> </table> <p><strong>返回参数</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>返回状态：0-处理成功，9999-异常，具体错误详见msg字段</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(128)</td> <td>返回信息：具体错误原因，例如：签名失败、参数格式校验错误</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(32)</td> <td>签名信息：对data内数据签名，如data为空则不返回</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Json</td> <td>返回数据：json格式数据</td> </tr> </tbody> </table> <p><strong>data数据格式</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">refundOrderId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(30)</td> <td>退款订单号</td> </tr> <tr> <td style="text-align: left;">mchRefundNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(30)</td> <td>商户退款单号</td> </tr> <tr> <td style="text-align: left;">payAmount</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>支付金额，单位分</td> </tr> <tr> <td style="text-align: left;">refundAmount</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>退款金额，单位分</td> </tr> <tr> <td style="text-align: left;">state</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>订单状态：0-订单生成 1-退款中 2-退款成功 3-退款失败 4-退款关闭 6-预消费退款</td> </tr> <tr> <td style="text-align: left;">channelOrderNo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>渠道退款单号</td> </tr> <tr> <td style="text-align: left;">errCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>渠道错误码</td> </tr> </tbody> </table>