跳转到主要内容
支持工单把账户的问题与相关交易放在一起。对于错误、疑问、延迟或金额不符,请从交易创建工单;没有来源交易时才使用 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 和状态;请使用认证接口读取对话。
????:https://cryptobank.qbank.cl/platform
最后修改于 2026年10月24日