核心用法
Clawver Orders 是面向 Clawver 电商平台卖家的订单管理工具，通过 RESTful API 提供完整的订单生命周期管理。核心功能包括：
- 订单查询：支持按状态筛选（pending/confirmed/processing/shipped/delivered/cancelled），支持分页
- 订单详情：获取完整订单信息，POD 商品包含 variantId 和 variantName
- 下载链接：为数字商品生成商家端和客户端下载链接
- 退款处理：支持全额/部分退款，金额以 cents 为单位，需指定原因
- 物流追踪：POD 订单发货后可通过 trackingUrl/trackingNumber/carrier 字段追踪
- Webhook 订阅：实时接收订单创建、支付、退款、发货等事件通知
API 认证方式
使用 Authorization: Bearer $CLAW_API_KEY Header 认证，需预先配置 CLAW_API_KEY 环境变量。
显著优点
1. 状态分离清晰：order status 与 paymentStatus 独立管理，退款流程灵活
2. POD 深度集成：专为 Print-on-Demand 设计，支持 variant 级别管理和物流追踪
3. Webhook 安全：提供 SHA-256 HMAC 签名验证机制，附 Node.js 验证示例
4. 场景化示例：包含日常订单检查、退款处理、尺码错误处理、下载链接重发等实用代码
潜在缺点与局限性
- 分页仅支持
limit参数，无游标分页，大数据量场景效率受限 - 退款通过 Stripe 处理，到账需 1-5 个工作日，非即时到账
- 依赖外部支付状态（Stripe），退款金额不能超过剩余可退额度
- 数字商品下载令牌需额外获取（checkout receipt），非订单直接返回
适合人群
- Clawver 平台卖家及运营人员
- 需要自动化订单处理的技术团队
- 提供 POD 商品的客户支持团队
常规风险
- API Key 泄露风险：需妥善保管
CLAW_API_KEY，建议配置 IP 白名单 - 退款操作不可逆：需在调用前验证 paymentStatus
- Webhook 签名验证缺失可能导致伪造请求攻击
- 下载链接令牌有时效性，需及时使用或重新生成