拒付

拒付查询

get

/openApi/chargebacks

Authorizations

Query parameters

endTimestring(19)required

交易结束时间，开始时间与结束时间最大不能超过半年的时间间隔；固定长度为19，如：2022-04-01T00:00:00

gatewayNointeger(8)

网关号；固定长度8位，如：10001001

merNointeger(5)

商户号；固定长度5位，如：10001

orderNostring(64)

商户订单号；最小长度为1，最大长度为64，如：12167001000000000001

pageIndexinteger(10)

当前页，默认第一页；最大长度为10，如：1

pageSizeinteger(10)

每页大小，默认每页100条数据，最大1000条；最大长度为10，如：100

startTimestring(19)required

交易开始时间，开始时间与结束时间最大不能超过半年的时间间隔；固定长度为19，如：2022-01-01T00:00:00

tradeNostring(64)

交易流水号；最小长度为1，最大长度为64，如：2021092810011380477264

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分钟

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://{openApiUrl}/openApi/chargebacks?endTime=null&startTime=null' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'request-id: null' \
  --header 'request-time: null'

200

200

{
  "data": {
    "list": [
      [
        {
          "amount": 10.22,
          "appealStatus": "non-represented",
          "batchNo": 30001,
          "cpdDate": "2021-05-12T00:00:00",
          "currency": "USD",
          "exeDate": "2021-05-12T00:00:00",
          "gatewayNo": 10001001,
          "merNo": 10001,
          "orderAmount": 10.22,
          "orderCurrency": "USD",
          "orderNo": 12167001000000000000,
          "reason": "chargeback reason",
          "remark": "remark",
          "replyDeadline": "2021-04-12T00:00:00",
          "status": "chargeback",
          "tradeDate": "2021-04-12T00:00:00",
          "tradeNo": 2.0210928100113805e+21
        }
      ]
    ],
    "page": {
      "pageIndex": 1,
      "pageSize": 100,
      "total": 1000
    }
  },
  "result": {
    "code": "text",
    "message": "text"
  }
}

OK

请求报文示例

chargebacks.sh

curl --request GET\
  --url https://{openApiUrl}/openApi/chargebacks?gatewayNo=12345001&endTime=2022-05-01T00:00:00&orderNo=20220429103335&pageIndex=1&pageSize=10&startTime=2021-12-01T00:00:00&tradeNo=2022042910362912053026 \
  --header 'request-id: 58675' \
  --header 'request-time: 2022-05-21T23:59:59' \
  --header 'authorization:Bearer 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822' \

拒付查询

get

/openApi/chargebacks

Authorizations

Query parameters

endTimestring(19)required

交易结束时间，开始时间与结束时间最大不能超过半年的时间间隔；固定长度为19，如：2022-04-01T00:00:00

gatewayNointeger(8)

网关号；固定长度8位，如：10001001

merNointeger(5)

商户号；固定长度5位，如：10001

orderNostring(64)

商户订单号；最小长度为1，最大长度为64，如：12167001000000000001

pageIndexinteger(10)

当前页，默认第一页；最大长度为10，如：1

pageSizeinteger(10)

每页大小，默认每页100条数据，最大1000条；最大长度为10，如：100

startTimestring(19)required

交易开始时间，开始时间与结束时间最大不能超过半年的时间间隔；固定长度为19，如：2022-01-01T00:00:00

tradeNostring(64)

交易流水号；最小长度为1，最大长度为64，如：2021092810011380477264

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分钟

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://{openApiUrl}/openApi/chargebacks?endTime=null&startTime=null' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'request-id: null' \
  --header 'request-time: null'

200

200

{
  "data": {
    "list": [
      [
        {
          "amount": 10.22,
          "appealStatus": "non-represented",
          "batchNo": 30001,
          "cpdDate": "2021-05-12T00:00:00",
          "currency": "USD",
          "exeDate": "2021-05-12T00:00:00",
          "gatewayNo": 10001001,
          "merNo": 10001,
          "orderAmount": 10.22,
          "orderCurrency": "USD",
          "orderNo": 12167001000000000000,
          "reason": "chargeback reason",
          "remark": "remark",
          "replyDeadline": "2021-04-12T00:00:00",
          "status": "chargeback",
          "tradeDate": "2021-04-12T00:00:00",
          "tradeNo": 2.0210928100113805e+21
        }
      ]
    ],
    "page": {
      "pageIndex": 1,
      "pageSize": 100,
      "total": 1000
    }
  },
  "result": {
    "code": "text",
    "message": "text"
  }
}

OK

结果对象属性描述

property name	type	description
result	Object	请求响应对象
code	String	响应码
message	String	响应信息
data	Object	数据体
page	Object	分页对象
total	Integer	总记录条数
pageSize	Integer	每页数据条数
currentPageNo	Integer	当前页
list	Array	列表
merNo	Integer	商户号
gatewayNo	Integer	网关号
batchNo	String	退款编号
tradeNo	String	交易流水号
orderNo	String	商户订单号
orderAmount	double	订单金额
orderCurrency	String	订单币种
amount	double	拒付金额
currency	String	交易币种
reason	String	拒付原因
tradeDate	String	交易时间
cpdDate	String	cpd时间
replyDeadline	String	回复截止时间
status	String	拒付状态 -1：失败 0：待审核 1：审核成功未处理 2：审核成功已处理
exeDate	String	执行时间
appealStatus	String	申诉状态 -2：未申诉 -1：申诉待处理 0：申诉失败 1：申诉成功
remark	String	备注