退款

退款申请

退款申请

POST//unknown/openApi/refund

Authorization

Authorization

Header parameters

Body

application/json

传入json格式

merTrackNostring(50)

商户跟踪号，用户商户唯一标识一笔退款记录；最小长度为1，最大长度为50，如：454515154

Example: 454515154

refundAmountstring(11)

退款金额，最多两位小数；最小长度为1，最大长度为11，如：10.22

Example: 10.22

refundReason*string(100)

退款原因，字段过长会被截取；最小长度为1，最大长度为100，如：退款

Example: "退款"

refundTypeinteger(1) (int32)

退款类型 1全额退款; 2部分退款；固定长度为1，如：1

Example: 1

remarkstring(100)

退款备注，传输什么就返回什么，字段过长会被截取；最小长度为1，最大长度为100，如：备注

Example: "备注"

tradeNo*string(64)

流水订单号；最小长度为1，最大长度为64，如：202101010000

Example: 202101010000

Response

200

OK

Body

*/*response body

dataRefundDataResp

openApi退款响应对象

resultResult

Request

JavaScriptCurlPythonHTTP

const response = await fetch('//unknown/openApi/refund', {
    method: 'POST',
    headers: {
      "authorization": "text",
      "request-id": "text",
      "request-time": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "refundReason": "退款",
      "tradeNo": 202101010000
    }),
});
const data = await response.json();

Response

200

{
  "data": {
    "batchNo": 30002,
    "gatewayNo": 10001001,
    "merNo": 10001,
    "refundDescription": "退款描述",
    "refundReason": "尺寸不对",
    "refundStatus": "refund",
    "tradeNo": 202101010000
  },
  "result": {
    "code": "text",
    "message": "text"
  }
}

退款申请接口请求报文示例

applyRefund.sh

curl --request POST \
  --url https://{openApiUrl}/openApi/refund \
  --header 'Content-Type: application/json' \
  --header 'request-id: 58675' \
  --header 'request-time: 2022-05-21T23:59:59' \
  --header 'authorization:Bearer 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822' \
  --data '{
    "merTrackNo": "7313961647432084782",
    "refundAmount": "0.01",
    "refundReason": "0.01",
    "refundType": "2",
    "remark": "remark",
    "tradeNo": "2022051812003332818907"
}'

退款查询

退款查询

GET//unknown/openApi/refund/{batchNo}

Authorization

Authorization

Path parameters

batchNo*integer (int32)

退款编号；最小长度为1，最大长度为10，如：736743

Header parameters

Response

200

OK

Body

*/*response body

dataRefundDataResp

openApi退款响应对象

resultResult

Request

JavaScriptCurlPythonHTTP

const response = await fetch('//unknown/openApi/refund/{batchNo}', {
    method: 'GET',
    headers: {
      "authorization": "text",
      "request-id": "text",
      "request-time": "text"
    },
});
const data = await response.json();

Response

200

{
  "data": {
    "batchNo": 30002,
    "gatewayNo": 10001001,
    "merNo": 10001,
    "refundDescription": "退款描述",
    "refundReason": "尺寸不对",
    "refundStatus": "refund",
    "tradeNo": 202101010000
  },
  "result": {
    "code": "text",
    "message": "text"
  }
}

退款查询请求报文示例

refund.sh

curl --request GET\
  --url https://{openApiUrl}/openApi/refund/442011 \
  --header 'request-id: 58675' \
  --header 'request-time: 2022-05-21T23:59:59' \
  --header 'authorization:Bearer 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822' \

结果对象属性描述

property name	type	description
result	Object	请求响应对象
code	String	响应码
message	String	响应信息
data	Object	数据对象
merNo	Integer	商户号
gatewayNo	Integer	网关号
batchNo	String	退款编号，唯一
refundDescription	String	退款描述
refundReason	String	退款原因
refundStatus	String	退款状态 -1：失败 0：待审核 1：审核成功未处理 2：审核成功已处理
tradeNo	String	交易流水号