kind: general。交易工单保存只读的收据快照。
创建工单
kind 必须是 payout、payin、payin_refund、transfer、crypto_withdrawal、crypto_deposit、swap、card_purchase、banking_operation、wallet_send 或 wallet_deposit。发送 resource_id;general 工单必须使用 general 类别并省略该字段。
201。 idempotency_key 最多 128 个字符;超过限制会返回 400 invalid_payload。 幂等键按账户限定:去重使用 (组织、账户、idempotency_key),不同账户可以独立使用相同密钥。使用相同密钥重放会返回原工单并带有 idempotency_hit: true,不会创建重复工单。同一交易已有开放工单时返回 409 ticket_already_open,并附上现有工单。
查看并继续对话
使用GET /v1/support/tickets?from=2026-10-01&to=2026-10-31&page=1&page_size=50 列表。还可以按 status、category、priority 和 kind 过滤;page_size 最大为 200。详情包括 snapshot、公开消息和附件元数据。内部备注永远不会返回给账户。
pending_customer、on_hold 或 resolved 重新打开为 open。closed 是终态,请创建新工单。
附件
使用 multipart 字段file 上传一个 PDF、PNG 或 JPG,最大 10 MiB。服务器会检查真实文件签名。下载是经过认证的二进制响应,不要公开 download_url。
关闭和评价
POST /v1/support/tickets/{id}/close 具有收敛性:关闭已关闭工单会返回当前详情。解决后只能评价一次,rating 为 1 到 5,评论最多 1,000 个字符。重复评价返回 409 already_rated。
状态、SLA 和错误
默认首次回复 SLA 按 low、normal、high、urgent 分别为 4 小时、2 小时、1 小时和 30 分钟;解决 SLA 为 48、24、8 和 4 小时。组织可以配置这些值,
sla_breached 由服务器计算。
请参阅错误目录和webhook 事件。
常见问题
可以不关联交易创建工单吗?
可以不关联交易创建工单吗?
可以。使用
kind: general,省略 resource_id 并设置 category: general。账户能看到内部备注吗?
账户能看到内部备注吗?
不能。内部备注仅供组织管理员查看,也不会出现在账户响应或事件中。
事件是否包含消息正文?
事件是否包含消息正文?
不包含。事件只有 ID 和状态;请使用认证接口读取对话。