提交工单

POST https://api.supertopads.com/v1/orders
Content-Type: application/json

请求体必须为 JSON 对象，最多 32 KB。不支持压缩请求体、查询参数或路径末尾的 /。

请求字段

字段	类型	必填	说明
account_demand_id	integer	是	你方请求 ID，全局唯一；范围 1–9007199254740991
timezone	string	是	IANA 时区标识，如 America/Los_Angeles、Asia/Shanghai
currency	string	是	ISO 4217 有效三字母大写代码，如 USD、CNY
card_info	object	是	卡片信息对象
card_info.card_no	string	是	12–19 位数字字符串；不能传 JSON 数字

仅接受上表字段。时区与币种会按官方名单校验。标准代码有效不代表后续业务支持该币种，卡号格式通过也不代表卡片可用。参见时区、币种与官方标准。

请求示例

下列卡号是公开测试号码，用于展示结构，不是客户卡片。示例请求 ID 请替换为你方生成的唯一值。

{
  "account_demand_id": 123456,
  "timezone": "America/Los_Angeles",
  "currency": "USD",
  "card_info": {
    "card_no": "4242424242424242"
  }
}

成功响应

只有数据成功提交到数据库后才返回 HTTP 202 Accepted：

{
  "order_id": "76d6239c-6892-49d8-b960-e7274b236e11",
  "status": "PENDING"
}

order_id 为不透明 UUID，请完整保存。不要自行解析它或用它推断状态。

重复提交

• 相同 account_demand_id、相同内容：返回原 order_id 和当前状态，不创建新工单。
• 相同 account_demand_id、不同内容：返回 HTTP 409 / ACCOUNT_DEMAND_ID_CONFLICT，原工单不变。
• IANA 官方别名会规范化，例如 US/Pacific 与 America/Los_Angeles 视为相同；不要使用旧格式 GMT -8:00。
• 重复提交不会把 PROCESSING 或 COMPLETED 重置为 PENDING。

卡号加密保存，不在回执或请求日志中返回。不要发送 CVV、密码或其他未定义的敏感字段。