查询退款订单列表

GET 
/refund/list

分页查询商户的退款订单列表。

Request

Query Parameters

chainId int32

链 ID

此为平台内部 ID，不是链上或者钱包里的链 ID，可以从查询链列表接口获取

page int64

Possible values: >= 1 and <= 1000000

Default value: 1

页码

size int64

Possible values: <= 500

Default value: 10

每页显示的记录数

orderStatus int32
Possible values: [0, 1, 2, 3, 4, 5]
退款订单状态
• 0 - 成功
• 1 - 待审批
• 2 - 审批中
• 3 - 区块确认中
• 4 - 失败
• 5 - 驳回
transactionHash string

交易哈希

startTime int64

订单创建开始时间

格式：Unix 时间戳，单位：秒

endTime int64

订单创建结束时间

格式：Unix 时间戳，单位：秒

Responses

200

OK

application/json

Schema

Schema

code int32required

状态码

msg stringrequired

成功或错误提示

description string

错误提示详情

data

object

分页结果对象

count int64required

符合条件的记录总数

page int64required

当前查询的页码

size int64required

每页显示的记录数

list

object[]

required

Array [

chainId int32required

链 ID

此为平台内部 ID，不是链上或者钱包里的链 ID，可以从查询链列表接口获取

currencyId int32required

货币 ID

可以从查询货币列表接口获取

refundId int32required

退款订单 ID

outTradeNo stringrequired

商户订单号

outPaymentNo stringrequired

支付单号

refundAddress stringrequired

退款地址

refundAmount stringnullablerequired

退款金额

注：该字段的值为整型数字，通过 (实际金额 * 10^货币小数位数) 计算而来

refundFee stringnullable

手续费

refundStatus int32required

Possible values: [0, 1, 2, 3, 4, 5]

退款订单状态

• 0 - 成功
• 1 - 待审批
• 2 - 审批中
• 3 - 区块确认中
• 4 - 失败
• 5 - 驳回

refundTime date-timerequired

退款时间

transferHash stringnullable

交易哈希

]

Example (from schema)

{
  "code": 0,
  "msg": "string",
  "description": "string",
  "data": {
    "count": 0,
    "page": 0,
    "size": 0,
    "list": [
      {
        "chainId": 0,
        "currencyId": 0,
        "refundId": 0,
        "outTradeNo": "string",
        "outPaymentNo": "string",
        "refundAddress": "string",
        "refundAmount": "string",
        "refundFee": "string",
        "refundStatus": 0,
        "refundTime": "2024-07-29T15:51:28.071Z",
        "transferHash": "string"
      }
    ]
  }
}

Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 1,
    "size": 10,
    "count": 4,
    "list": [
      {
        "refundId": 90,
        "chainId": 1,
        "currencyId": 1,
        "outTradeNo": "202401191415017506131",
        "outPaymentNo": "202401191415018327151",
        "refundStatus": 1,
        "refundAddress": "TQKGPBRB9rQc99rqDqp2jGKfcup19LaziM",
        "refundAmount": null,
        "transferHash": null,
        "refundFee": null,
        "refundTime": "2024-01-22 19:04:30"
      },
      {
        "refundId": 84,
        "chainId": 1,
        "currencyId": 2,
        "outTradeNo": "202401191412398586291",
        "outPaymentNo": "202401191412399750523",
        "refundStatus": 0,
        "refundAddress": "TSBJBk1Nfc7sxYp59bjTtLEV8WKxZcZy2L",
        "refundAmount": "5000000",
        "transferHash": "b4694f07f1699a145d2a20a7bc52608d3976b7f9df18cdf0e773a567aec9b991",
        "refundFee": "0",
        "refundTime": "2024-01-19 23:17:03"
      },
      {
        "refundId": 82,
        "chainId": 1,
        "currencyId": 1,
        "outTradeNo": "202401181646089709495",
        "outPaymentNo": "202401181646089688773",
        "refundStatus": 0,
        "refundAddress": "TSBJBk1Nfc7sxYp59bjTtLEV8WKxZcZy2L",
        "refundAmount": "90000000",
        "transferHash": "fb8b8e8a62a0bad406832a5ab14968d97582998571d240e4969077436bddde0b",
        "refundFee": "0",
        "refundTime": "2024-01-19 00:48:41"
      },
      {
        "refundId": 81,
        "chainId": 1,
        "currencyId": 2,
        "outTradeNo": "202401181606495075981",
        "outPaymentNo": "202401181606494014830",
        "refundStatus": 0,
        "refundAddress": "TSBJBk1Nfc7sxYp59bjTtLEV8WKxZcZy2L",
        "refundAmount": "10000000",
        "transferHash": "c6aae5a3d132db3a5f9d7230dbab9c4ea4e2062bbb37324f52f3f89b6d18b441",
        "refundFee": "0",
        "refundTime": "2024-01-19 00:24:46"
      }
    ]
  }
}

401

Unauthorized

403

Forbidden

404

Not Found

Loading...