退款

Previous支付方式查询 Next拒付

Last updated 2 years ago

退款申请

post

/openApi/refund

Authorizations

Header parameters

authorizationanyrequired

ACCESS_TOKEN，格式：Bearer ACCESS_TOKEN

request-idstring(20)required

请求id，最小长度为1，最大长度为20，30分钟之内唯一

request-timestring(19)required

请求时间，时间格式为 yyyy-MM-dd'T'HH:mm:ss ，请求误差不能超过30分钟

Body

merTrackNostring(50)

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

Example: 454515154

refundAmountstring(11)

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

Example: 10.22

refundReasonstring(100)required

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

Example: 退款

refundTypeinteger(1) · int32

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

Example: 1

remarkstring(100)

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

Example: 备注

tradeNostring(64)required

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

Example: 202101010000

Responses

*/*

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'http://{openApiUrl}/openApi/refund' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'request-id: null' \
  --header 'request-time: null' \
  --header 'Content-Type: application/json' \
  --data '{
    "merTrackNo": 454515154,
    "refundAmount": 10.22,
    "refundReason": "退款",
    "refundType": 1,
    "remark": "备注",
    "tradeNo": 202101010000
  }'

200

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

退款查询

get

/openApi/refund/{batchNo}