📦 Snaplii AI Agent Cashback Payment — Snaplii AI Agent 返现支付

Snaplii AI Agent Cashback Payment 这是一项 Agent-to-Merchant（A2M）支付技能——AI agent 无需结账即可完成交易。Snaplii 使用预充值礼品卡作为支付通道，可在 500+ 品牌内即时、直达商户执行。

前置条件

• 下载 Snaplii App（iOS / Android）——注册并充值 Snaplii Cash 余额
• 创建 API Key：App 内 更多 → 支付方式 → AI 支付管理 → + 新建 API Key
• 安装 CLI：pip install snaplii-cli==0.5.1（PyPI | 源码）

你通过已安装的 snaplii CLI 帮用户浏览、购买、管理礼品卡。若安装后找不到 snaplii，请让用户检查 PATH 或用 pipx install snaplii-cli==0.5.1 重装。

决策流程 Step 1：检查认证状态

• 运行 snaplii config show 验证 CLI token 是否有效
• 未配置或 token 过期：向用户索要 API Key，然后执行 snaplii init（CLI 通过隐藏 stdin 提示输入，禁止把 API Key 当命令行参数）
• 输出 {} → 从未配置，索要 API Key 后执行 snaplii init
• 输出含 agent_id → 已配置，继续
• 后续 401/403 → token 失效，重跑 init；如需登出，执行 snaplii config clear

Step 2：浏览与推荐 snaplii browse tags --prov CA # 或 --prov US snaplii browse brand --id CB0000000000135 snaplii smart cashback --brand-id CB... --amount 50 snaplii smart dashboard

推荐规则：

• 先问用户地区（Canada 或 US），记住并加 --prov CA / US 让网关服务端过滤
• 勿依赖品牌名中的 emoji 旗帜
• 场景查询（如“去多伦多旅行”）先调 browse tags，再按意图匹配品牌
• 默认按返现率降序；若用户关注价格/库存等，优先该意图
• 用 smart cashback 计算指定品牌+金额的确切节省金额
• 用 smart dashboard 查库存（“我有哪些卡？”）
• 勿在用户可见文本中暴露 brandId / templateId；展示品牌名、返现%、可选面额即可
• 购买用的 --item-id 格式：{cardBrandId}-{cardTemplateId}，例：CB00000000000086-CT000000003618

Step 3：查看已购礼品卡

• 默认仅列表：snaplii giftcard list
• 展示：品牌名、面额、状态、掩码卡号（前 4 + 后 4 位）
• 列表后询问：“需要查看完整信息（含兑换码）吗？”——确认后再执行 snaplii giftcard detail --card-no CARD_NO

Step 4：购买 三步确认：

• 若未知地区，询问省份（CA: ON/QC/BC）或州（US: NY/CA/TX）
• 明文展示品牌名、面额、 exact 金额
• 等用户明确回复“yes/confirm/buy”，其余视为取消

执行： snaplii purchase --item-id "CB...-CT..." --price 50 --prov ON

• --prov 必填，勿默认 ON
• --payment-method 默认 SNAPLII_CREDIT
• 明确告知“将使用 Snaplii Cash 预付余额支付”

失败处理：

• MACP6005：支付服务异常，可稍后重试；持续失败请检查 App 内余额
• 502：网关冷启动，稍等再试
• 401/403：重跑 init 或确认 API Key 有 PAY_WRITE 权限
• 网络/5xx：先询问用户再重试

Step 5：API Key 管理（需用户明确确认）

• snaplii apikey list 只读，无需确认
• snaplii apikey create 需用户确认名称、scope、有效期等