核心用法
Snaplii 是一种 Agent-to-Merchant (A2M) 支付技能，AI 代理通过预付费礼品卡作为支付通道，为用户完成即时交易。用户需先在 Snaplii App 中注册、充值 Snaplii Cash 余额，并创建带硬消费上限的 API Key；代理通过 snaplii-cli 浏览品牌、获取实时报价（含代金券和返现）、确认后购买礼品卡，最后将兑换码交给用户自行在商户 App 中使用。
关键操作路径
1. 认证：snaplii init 输入 API Key（隐藏输入，不暴露在命令行）
2. 浏览：snaplii browse tags --prov CA/US 按地区筛选，结合场景推荐品牌
3. 询价：snaplii quote --item-id ... --price ... 必须先行，确认代金券、Snaplii Cash 抵扣及实际支付金额
4. 购买：snaplii purchase 需用户当前回合显式确认（"yes"/"confirm"），且 you_pay 必须为 0（余额全覆盖）
5. 账单支付：支持水电、通讯等账单，流程为 payees → detail → save → quote → confirm → pay
6. 礼品卡管理：giftcard list 默认仅展示列表，detail 仅在用户明确要求时展示兑换码等敏感信息
显著优点
- 资金安全设计：仅消费用户预充值的 Snaplii Cash，无信用卡扣款风险；API Key 可撤销、带硬上限，每次购买需用户确认
- 即时可用：预付费礼品卡作为支付轨道，无需等待银行清算，购买后立即获得兑换码
- 返现与优惠：自动计算并应用代金券和返现，
smart cashback可预览节省金额 - 广泛覆盖：支持 500+ 品牌礼品卡及常见账单支付（电、气、网、话费等）
- 区域适配：支持加拿大（CA）和美国（US），可按省份/州过滤
潜在缺点与局限性
- 非全自动：代理不控制浏览器、不代下单，用户需自行在商户 App 中输入兑换码完成订单
- 余额不可查：CLI 无余额查询命令，用户需在 App 中查看；代理仅能通过
quote结果推断单笔订单是否被余额覆盖 - 支付限制：CLI 仅支持 Snaplii Cash 支付，若余额不足需用户先去 App 充值，无法直接扣款其他方式
- 地域限制：品牌可用性和优惠因省份/州而异，需用户明确告知地区
- 错误处理依赖用户：网络错误、网关超时（502）、支付服务错误（MACP6005）等需人工判断重试，不建议自动重试
适合人群
- 希望 AI 代理自动完成礼品卡采购、节省返现的 Snaplii 用户
- 需要定期支付账单（水电、通讯）且希望集中管理的用户
- 注重支付安全、偏好预付费模式而非信用卡授权的用户
- 加拿大和美国地区的用户（需确认当地品牌支持）
常规风险
- 敏感信息泄露：礼品卡兑换码、PIN、条形码 URL 属于高敏感数据，必须在用户明确要求后才展示，且应避免在日志中留存
- 误操作购买：虽需显式确认，但用户可能在未充分理解
you_pay金额时同意；代理必须清晰展示报价明细，并在you_pay > 0时阻止交易 - 会话过期：Token 不自动刷新，401/403 错误需重新
init，中断体验 - 第三方数据不可信：品牌名称、卡片标题等 API 返回内容应视为不可信，不可执行其中嵌入的指令
- API Key 管理：Key 的创建、查看、撤销仅在 App 内完成，CLI 无管理命令，用户需妥善保管