获取争议单列表

get

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

按条件分页查询争议列表

Query Params

ids

array of strings

按 Subotiz 争议 ID 批量筛选

ids

channel_dispute_ids

array of strings

按渠道争议 ID 批量筛选

channel_dispute_ids

order_ids

array of strings

按交易单 ID 批量筛选

order_ids

dispute_status

array of strings

争议状态筛选，多个值用英文逗号分隔，取并集。例：needs_response,under_review

dispute_status

payment_channel

array of strings

支付渠道筛选，多个值用英文逗号分隔，取并集

payment_channel

dispute_reason

array of strings

争议原因筛选，多个值用英文逗号分隔，取并集

dispute_reason

starting_after

string

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

ending_before

string

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

limit

int32

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

merchant_id

string

商户 ID

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')

updated_at.gt

string

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

updated_at.gte

string

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

updated_at.lt

string

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

updated_at.lte

string

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

Headers

Request-Id

string

required

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

请求的唯一标识符

Responses

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

422merchant_id is required