测试模式 · 不生成真实订单

OUACC API Sandbox

成熟账号商城通常需要代理 API、库存同步、订单查询和 Webhook 回调。OUACC 当前只开放公开目录接口;本页提供测试模式样例,方便未来代理/批发客户提前理解字段和边界。

沙盒不会创建真实订单,不锁库存,不触发支付,不返回卡密,不发放真实 API Key,也不向外部地址发送 Webhook。

1测试订单
0真实订单
0API 凭据
0真实卡密
沙盒状态:api_sandbox_enabled=truereal_order_api_enabled=falseapi_credentials_issued=falsewebhook_delivery_enabled=falsecard_secret_returned=false
OUACC Account

沙盒能力

测试商品查询mock_only

读取固定示例商品,不返回真实库存、价格或卡密。

GET /api-sandbox.json#test_product
测试订单状态mock_only

展示固定测试订单生命周期,不创建站内订单。

GET /api-sandbox.json#test_order
Webhook 样例mock_only

展示回调字段、事件名和签名思路,不向外部地址发送请求。

GET /api-sandbox.json#webhook_sample
签名规则draft

未来使用时间戳、请求体和密钥计算签名;当前不发放真实密钥。

HMAC-SHA256 draft
速率限制planned

正式 API 开通前将设置 IP、Key、订单和库存查询频率限制。

rate_limit_enabled=false
错误码draft

定义库存为空、支付未开通、签名失败、权限不足等错误边界。

sandbox_error_catalog

接口边界

方法路径说明
GET/api-sandbox.json沙盒说明、示例商品、示例订单、Webhook 样例。
GET/api/v1/public/config真实公开配置接口,已移除默认联系方式。
GET/api/v1/public/categories真实公开分类接口。
GET/api/v1/public/products真实公开商品接口;当前无正库存可购买商品。
POST/api/v1/orders未开放;正式开售前不接受真实 API 下单。
POST/api/v1/webhooks/test未开放;当前只展示样例,不发送真实回调。

Webhook 样例

{
  "event": "order.mock_paid",
  "mode": "sandbox",
  "request_id": "req_test_ouacc_0001",
  "timestamp": "2026-06-11T00:00:00Z",
  "data": {
    "id": "test_order_20260611_0001",
    "mode": "sandbox",
    "status": "paid_test",
    "amount": "0.00",
    "currency": "USD",
    "product_slug": "ouacc-telegram-monthly-001",
    "quantity": 1,
    "delivery_status": "mock_only",
    "card_secret": null,
    "created_at": "2026-06-11T00:00:00Z"
  }
}

正式开放前要求

  • 真实库存、支付、锁库存、自动发货和售后工单闭环通过后,才能开放真实下单 API。
  • API Key、Webhook Secret、IP 白名单、签名验签和速率限制完成前,不发放真实凭据。
  • 沙盒响应中的订单、商品、价格和卡密都是测试数据,不可用于交付或售后。
  • 代理客户正式对接前,需要确认价格表、库存同步、回调失败重试和退款/补发边界。
  • 任何 API 文档变更都要同步 OpenAPI、状态 JSON、公告和代理合作页面。

机器可读状态

自动化系统可读取 /api-sandbox.json。生成时间:2026-06-11T08:42:25.516819Z。当前 transactional_api_ready=falsewebhook_delivery_enabled=false