查询 Refund 列表

GET
/openapi/v1/payment-intents/{paymentIntentId}/refunds

分页查询指定 Payment Intent 下的退款。

鉴权

bearerAuth
header鉴权Bearer <令牌>

通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。

路径参数

paymentIntentId*string

Payment Intent ID,如 pi_MNOL0POUV8IDPXCD

查询参数

pageNum?integer

页码,从 1 开始,默认 1

范围1 <= value
默认值1
pageSize?integer

每页数量,默认 10,最大 1000

范围1 <= value <= 1000
默认值10
status?string

按退款状态过滤,取值见 Refund 状态

可选值"PENDING_APPROVAL""PROCESSING""COMPLETED""FAILED"
createdAfter?string

创建时间起点(含),ISO 8601 带时区偏移

createdBefore?string

创建时间终点(含),ISO 8601 带时区偏移

响应体

分页结构同 Payment Intent 列表。records[] 中每个对象为 Refund 对象。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

请求追踪 ID。联系技术支持时请提供

data?
请求示例
curl -X GET 'https://api.test.stabofx.com/openapi/v1/payment-intents/string/refunds'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "6a018b61edce0fed70c0e9464c51b86e",  "data": {    "records": [      {        "refundId": "re_IFWNVQP0O6EHB6KV",        "paymentIntentId": "pi_TZA3DEDJUNZLTUJ2",        "amount": "10.00",        "currency": "USD",        "status": "COMPLETED",        "reason": "REQUESTED_BY_CUSTOMER",        "notes": "Customer requested a partial refund.",        "metadata": {},        "createdAt": "2026-05-11T17:18:41+08:00",        "completedAt": "2026-05-11T18:02:10+08:00"      }    ],    "total": 1,    "size": 10,    "current": 1,    "pages": 1  }}