4.2.1 实时退款 - 易企通2.0

1、功能说明
（1）退款规则：原交易存在、且原交易可退金额大于等于本次退款金额、且商户当日正向交易头寸大于等于本次退款金额。
（2）支持部分退款、全额退款。

2、支持对以下交易发起退款
（1）原交易分账标识为0
（2）原交易延时结算标识为0
（3）原交易分账标识为1或2，且尚未发起分账，对主单发起退款
（4）原交易为合单支付，对子单发起退款
（5）原交易分账标识为1或2，针对已成功分账回退的金额，可以通过本接口发起实时退款。

请求参数

Body 参数application/json

reqBody

object

请求体

必需

reqInfo

object

请求方信息

必需

reqOrderInfo

object

基础订单信息

必需

payInfo

object

支付信息

必需

qrCodeRefundExt

object

AT交易退货请求扩展信息

可选

示例

{
  "reqHeader": {
    "transTime": "20241101140850",
    "reqId": "531000023045074"
  },
  "reqSign": "NGKzPopRk0rMiOJD7/LlmWKql9dAoozE9cuFJa3jM/2MmUTm3i+/JD+Ugc4w83wHtKhlCs8Q4IEYMDnuJtYFhgCgrqiNkRaccSqzbwkUJpnkMwfLCi/zmF7ylpFy2KpmgQG7/O8R3XR2zVtgyId7vckAtbwOa8/axQanv2yv3mjLmDZTWSMtBBIJopoif7UgKlOZ5vjof1k+nKGb9GZRHSJzT+M5bp+QEjnZNXfZgvuaDL7XcwVJoETy6pe9XThj8eqXTd1ifKl0W0RWHi1KlZR4TWfiW6Dee5y8OyXtUQHy0q2YD0RO4C9ZtZmy2wAXwNNQsNttXPvYRO3G4pQOSQ==",
  "reqBody": {
    "reqInfo": {
      "mchtCode": "531000023045074"
    },
    "reqOrderInfo": {
      "orgTrace": "90019865941344168500",
      "oriOrgTrace": "8136502117513466291865",
      "oriTransDate": "20241101",
      "refundAmount": "1"
    },
    "payInfo": {
      "transDate": "20241101"
    }
  }
}

返回响应

🟢200OK

application/json

Body

rspBody

object

实时退款响应

可选

respStateInfo

object

返回码信息

可选

详见附录F.1

respOrderInfo

object

基础订单信息

可选

settleRespParamInfo

object

清算信息

可选

示例

请求报文

{
  "reqHeader": {
    "transTime": "20241101140850",
    "reqId": "531000023045074"
  },
  "reqSign": "NGKzPopRk0rMiOJD7/LlmWKql9dAoozE9cuFJa3jM/2MmUTm3i+/JD+Ugc4w83wHtKhlCs8Q4IEYMDnuJtYFhgCgrqiNkRaccSqzbwkUJpnkMwfLCi/zmF7ylpFy2KpmgQG7/O8R3XR2zVtgyId7vckAtbwOa8/axQanv2yv3mjLmDZTWSMtBBIJopoif7UgKlOZ5vjof1k+nKGb9GZRHSJzT+M5bp+QEjnZNXfZgvuaDL7XcwVJoETy6pe9XThj8eqXTd1ifKl0W0RWHi1KlZR4TWfiW6Dee5y8OyXtUQHy0q2YD0RO4C9ZtZmy2wAXwNNQsNttXPvYRO3G4pQOSQ==",
  "reqBody": {
    "reqInfo": {
      "mchtCode": "531000023045074"
    },
    "reqOrderInfo": {
      "orgTrace": "90019865941344168500",
      "oriOrgTrace": "8136502117513466291865",
      "oriTransDate": "20241101",
      "refundAmount": 1
    },
    "payInfo": {
      "transDate": "20241101"
    }
  }
}

应答报文
{
  "rspBody": {
      "respStateInfo": {
          "respDesc": "SUCCESS",
          "transStatusDesc": "处理成功",
          "appendRetMsg": "成功",
          "appendRetCode": "SUCCESS",
          "transState": "0",
          "respCode": "000000"
      },
      "settleRespParamInfo": {
          "settleTime": "20241101140907",
          "settleAmt": 1,
          "settleDate": "20241101"
      },
      "respOrderInfo": {
          "orgTrace": "90019865941344168500",
          "outTrace": "9962607322962750971904",
          "productTrace": "YQ20241101140904698",
          "pcTrace": "50103701032024110180695573153",
          "unTrace": "50103701032024110180695573153",
          "refundAmount": 1
      }
  },
  "rspHeader": {
      "easyPayCertificateId": "00000000",
      "rspCode": "000000",
      "rspInfo": "SUCCESS"
  },
  "rspSign": "cLPOBuyPs53UcEmpPWU5VmsLAXX+b8VgZxVAf2zVM03TCjYkLBK5QyDnzjMhfrTxCl92TGza+21FbpKayseomyBKk5O2ikqMQFfrvmPnTe6fiFzKLSMtxrw80DfpmrWerZON8K/BzdWRN8XYXxC6IlBThIaqz0jtgVkGucStdbQe+QTwHvb05kF0zNWOiqU9IbWkC8Uf01Dqkkqag4KvXsAY2vroONPyLxkCFGzfBo0R/sLVmljrlfh0mPaa2RP1tdyU9O1Gfe4B2qfQAUldafzh3b2rNqZ+2OQly+Jl94tNDZvRURfHgxtleyOTRQ7WzrZRDLV/E+vQh8R5vbb1pA=="
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found