获取交易单列表

get

https://{api}.subotiz.com/api/v1/trades

查询交易单列表

Query Params

trade_ids

array of strings

trade 单的 id 数组，筛选 id 属于这个数组 trade 单

trade_ids

status

string

状态：

requires_payment_method：待支付
payment_failed：支付失败
processing：支付处理中
succeeded：支付成功
closed：已关闭

starting_after

string

用于分页的游标。starting_after 是定义您在列表中位置的对象 ID。例如，如果想获取下一页，可以在第一次获取对象列表之后，使用最后一个对象的 id 作为参数值。不能和 `ending_before 同时使用

ending_before

string

用于分页的游标 ending_before 是定义您在列表中位置的对象 ID。例如，如果想获取上一页，可以在第一次获取对象列表之后，使用第一个对象的 id 作为参数值。不能和 starting_after 同时使用

limit

int32

分页参数，每页数量，默认：10，接口默认按创建时间倒序排序。限制：[1, 100]

order_ids

array of strings

接入方订单号

order_ids

created_at.gt

string

用于过滤的最小值（不包含，RFC3339格式的UTC时间，例如'2025-01-01T00:00:00Z')

created_at.gte

string

用于过滤的最小值（包含，RFC3339格式的UTC时间，例如'2025-01-01T00:00:00Z')

created_at.lt

string

用于过滤的最大值（不包含，RFC3339格式的UTC时间，例如'2025-01-01T00:00:00Z')

created_at.lte

string

用于过滤的最大值（包含，RFC3339格式的UTC时间，例如'2025-01-01T00:00:00Z')

customer_id

string

仅返回此顾客 ID 指定的顾客的交易订单。

Headers

Request-Id

string

required

Defaults to 008e3967-a1b5-48bb-be14-d5bff5092e61

请求的唯一标识符

Responses

200OK

400ending_before and starting_after cannot be set at the same time