查询 Refund 列表
GET
分页查询指定 Payment Intent 下的退款。
bearerAuthheader
鉴权Bearer <令牌>通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。
paymentIntentId*stringPayment Intent ID,如 pi_MNOL0POUV8IDPXCD
pageNum?integer页码,从 1 开始,默认 1
范围
1 <= value默认值
1pageSize?integer每页数量,默认 10,最大 1000
范围
1 <= value <= 1000默认值
10status?string按退款状态过滤,取值见 Refund 状态
可选值
"PENDING_APPROVAL""PROCESSING""COMPLETED""FAILED"createdAfter?string创建时间起点(含),ISO 8601 带时区偏移
createdBefore?string创建时间终点(含),ISO 8601 带时区偏移
分页结构同 Payment Intent 列表。records[] 中每个对象为 Refund 对象。
application/json- response
code?integer业务状态码
message?stringtraceId?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 }}