跳转到主要内容
GET
/
v2
/
payment
/
refunds
List all refunds
curl --request GET \
  --url https://api-sandbox.uqpaytech.com/api/v2/payment/refunds \
  --header 'x-auth-token: <api-key>' \
  --header 'x-client-id: <x-client-id>'
{
  "total_pages": 10,
  "total_items": 105,
  "data": [
    {
      "payment_refund_id": "RF123456789",
      "payment_attempt_id": "PA123456789",
      "amount": "10.01",
      "currency": "USD",
      "refund_status": "SUCCEEDED",
      "create_time": "2024-03-01T00:00:00+08:00",
      "update_time": "2024-03-01T00:00:00+08:00",
      "reason": "Order 1234 has been returned",
      "metadata": {
        "customer_id": "cust_12345",
        "order_id": "order_6789"
      }
    }
  ]
}

授权

​
x-auth-token
string
header
必填

The API token for login provided by UQPay.

请求头

​
x-client-id
string
必填

The API client id generated by UQPAY

查询参数

​
page_size
integer
必填

The maximum number of items to return per page. This number can be between 1 - 100

必填范围: 1 <= x <= 100
示例:

10

​
page_number
integer
必填

The page number to retrieve the next set of items. The number has to be greater than 1.

必填范围: x >= 1
示例:

1

​
start_time
string

Start time of Transaction. Default time range is 1 months.

示例:

"2024-03-01T00:00:00+08:00"

​
end_time
string

End time of Transaction. Maximum time range of 3 months.

示例:

"2024-03-01T00:00:00+08:00"

​
payment_intent_id
string

The ID of the payment intent to get refunds for

​
merchant_order_id
string

The merchant reference id created in merchant's system that corresponds to this PaymentIntent.

响应

200 - application/json

List of refunds retrieved successfully

​
total_pages
integer

The total pages of available items.

示例:

10

​
total_items
integer

The total counts of available items.

示例:

105

​
data
object[]