# 统一退款

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/refund/refundOrder:
    post:
      summary: 统一退款
      deprecated: false
      description: >-
        商户业务系统通过统一退款接口发起退款请求，支付网关会根据商户发起的支付订单号，找到对应到支付通道发起退款。

        请求类型：application/json 或 application/x-www-form-urlencoded

        文档地址：https://ndpay.qyyapp.com/api/2.%E9%80%80%E6%AC%BE%E6%8E%A5%E5%8F%A3/1.html
      tags:
        - 支付网关/退款接口
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                mchNo:
                  type: string
                  description: 商户号
                appId:
                  type: string
                  description: 应用ID
                currency:
                  type: string
                  description: 三位货币代码,人民币:cny
                reqTime:
                  type: string
                  description: 请求接口时间,13位时间戳
                version:
                  type: string
                  description: 接口版本号，固定：1.0
                sign:
                  type: string
                  description: 签名值，详见签名算法 https://ndpay.qyyapp.com/api/rule.html
                signType:
                  type: string
                  description: 签名类型，目前只支持MD5方式
                payOrderId:
                  type: string
                  description: 支付中心生成的订单号，与mchOrderNo二者传一即可
                mchOrderNo:
                  type: string
                  description: 商户生成的支付订单号，与payOrderId二者传一即可
                mchRefundNo:
                  type: string
                  description: 商户生成的退款单号
                refundAmount:
                  type: string
                  description: 退款金额
                refundReason:
                  type: string
                  description: 退款原因
                notifyUrl:
                  type: string
                  description: 退款完成后回调该URL,只有传了该值才会发起回调
                channelExtra:
                  type: string
                  description: 特定渠道发起的额外参数,json格式字符串.详见渠道参数说明
                extraParam:
                  type: string
                  description: 商户扩展参数,回调时会原样返回
                clientIp:
                  type: string
                  description: 客户端IPV4地址
              required:
                - mchNo
                - appId
                - mchRefundNo
                - refundAmount
                - currency
                - reqTime
                - version
                - sign
                - signType
                - refundReason
              x-apifox-orders:
                - mchNo
                - appId
                - payOrderId
                - mchOrderNo
                - mchRefundNo
                - refundAmount
                - currency
                - refundReason
                - clientIp
                - notifyUrl
                - channelExtra
                - extraParam
                - reqTime
                - version
                - sign
                - signType
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
          x-apifox-name: 成功
      security: []
      x-apifox-folder: 支付网关/退款接口
      x-apifox-status: developing
      x-run-in-apifox: https://app.apifox.com/web/project/4173425/apis/api-156154797-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://pay.jeepay.vip
    description: 正式环境
security: []

```