查询 Payment Intent 列表

GET
/openapi/v1/payment-intents

分页查询 Payment Intent。筛选条件通过 Query Parameters 传入。

鉴权

bearerAuth
header鉴权Bearer <令牌>

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

查询参数

pageNum?integer

页码,从 1 开始,默认 1

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

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

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

模糊搜索,匹配 referenceNo、description 或 metadata

customer?string

商户内部客户 ID

status?string

按状态过滤,取值见 Payment Intent 状态

可选值"AWAITING_PAYMENT""PROCESSING""PARTIALLY_PAID""PAID""COMPLETED""CANCELED"
currency?string

法币币种。传 amountMin 或 amountMax 时必填

amountMin?string

最小应付金额,标准单位,含边界

amountMax?string

最大应付金额,标准单位,含边界

createdAfter?string

创建时间起点(含),ISO 8601 带时区偏移,如 2026-05-01T00:00:00+08:00。在 URL 中传带 + 的时间偏移时,需要编码为 %2B

createdBefore?string

创建时间终点(含),ISO 8601 带时区偏移。在 URL 中传带 + 的时间偏移时,需要编码为 %2B

响应体

分页返回 Payment Intent 对象数组。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

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

data?
请求示例
curl -X GET 'https://api.test.stabofx.com/openapi/v1/payment-intents'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "6a01835979841629378301348ad084af",  "data": {    "records": [      {        "paymentIntentId": "pi_MNOL0POUV8IDPXCD",        "status": "CANCELED",        "clientSecret": "v1.xxx",        "checkoutUrl": "https://app.test.stabofx.com/en/checkout/pi_MNOL0POUV8IDPXCD?secret=v1.xxx",        "amount": "20.00",        "currency": "USD",        "referenceNo": "ORD-20260511-0001",        "receivedAmount": "0.00",        "refundedAmount": "0.00",        "hasRefund": false,        "cancellationReason": "SESSION_EXPIRED",        "expiresAt": "2026-05-11T14:42:34+08:00",        "canceledAt": "2026-05-11T14:43:00+08:00",        "createdAt": "2026-05-11T14:12:34+08:00",        "metadata": {}      }    ],    "total": 1,    "size": 10,    "current": 1,    "pages": 1  }}