API 文档 / 参考

请求签名：HMAC-SHA256(method + path + timestamp + nonce + SHA256(raw body))。

/merchant-api/v1/orders · merchant_order_no、amount_atomic、currency、network、notify_url、expires_in_seconds。金额使用 atomic units 的十进制字符串。

POST /api/v1/merchant-api/v1/orders
X-COCO-KEY: ck_your_key_id
X-COCO-TIMESTAMP: 1790790000
X-COCO-NONCE: random-unique-value
X-COCO-SIGNATURE: <hmac-sha256-hex>
Idempotency-Key: order-request-unique-id
Content-Type: application/json

{"merchant_order_no":"ORDER-1001","amount_atomic":"1000000","currency":"USDT","network":"TRON_TESTNET","notify_url":"https://merchant.example/callback","expires_in_seconds":1800}

查询订单

GET /api/v1/merchant-api/v1/orders/{merchant_order_no}

常见响应

成功响应包含订单 ID、支付金额、网络、收款地址和过期时间。

错误码

AUTH_FAILED、INVALID_REQUEST、INVALID_AMOUNT、UNSUPPORTED_NETWORK、ADDRESS_POOL_EMPTY、IDEMPOTENCY_CONFLICT。网络或地址池未配置时，创建请求会失败且不会创建可付款订单。