核心用法
clawver-orders 是专为 Clawver 电商平台设计的订单管理技能，提供完整的订单生命周期管理能力。核心功能包括：
订单查询与筛选：通过 RESTful API 获取订单列表，支持按状态（pending/paid/processing/shipped/delivered/cancelled/refunded）精准筛选，内置分页机制处理大规模数据。
订单详情追踪：获取单订单完整信息，涵盖支付状态、配送进度（POD 商品）、数字商品交付状态等关键字段。
下载链接管理：区分店主端（需 API Key）与顾客端（Token 验证）两种权限层级，支持数字商品下载链接的动态生成与重发。
退款处理：支持全额与部分退款，金额以 cents 为单位精确控制，退款通过 Stripe 处理（1-5 个工作日到账），自动校验可退款状态与余额。
Webhook 集成：提供实时事件推送机制（order.created/paid/shipped/refunded 等），支持 SHA-256 签名验证确保数据完整性。
显著优点
- 全链路覆盖：从订单创建到交付/退款的全生命周期管理，数字商品与 POD 实体商品双轨支持
- 权限分层设计：API Key 管理敏感操作，Token 机制保障顾客自助查询安全
- 标准化集成：RESTful 接口、标准分页、Webhook 签名验证，降低接入成本
- 财务合规性：退款金额强制 cents 单位、理由必填、状态校验，减少误操作风险
潜在局限
- 平台绑定：深度依赖 Clawver 生态，无法迁移至其他电商平台
- 退款时效：Stripe 1-5 天到账为外部依赖，不可控
- POD 追踪限制：物流信息依赖第三方供应商回传，存在延迟
- 无批量操作：API 未显式支持批量退款或批量下载链接生成
适合人群
- Clawver 平台店主及运营人员
- 电商客服团队（处理退款、补发下载链接）
- 需要自动化订单处理的开发者（配合 Webhook 实现工作流）
常规风险
- 密钥泄露：
CLAW_API_KEY暴露可能导致订单数据泄露或恶意退款 - Webhook 安全性：签名验证缺失会导致伪造事件注入
- 退款金额计算：部分退款时需自行校验 cents 单位与剩余可退金额，小数处理不当可能引发财务误差
- Token 过期：顾客端下载 Token 存在有效期，需妥善处理过期重发场景