Halocard — 用于在线购物的一次性虚拟信用卡

即时生成一次性虚拟信用卡，完成在线支付。 该技能作为用户所请求的**更大任务中的结账环节**使用。

配置

需要一个 Halocard token。若尚未配置：

1. 请用户注册：https://secure.halocard.co/enter
2. 请用户复制粘贴 API token：https://secure.halocard.co/dashboard
3. 将其保存为环境变量 HALOCARD_TOKEN

此技能的触发时机

这是一个支付步骤，而非独立任务。它在以下情况下触发：

• 你正在执行一项需要在线购买的任务（例如：点餐、购买商品、订阅服务等）
• 你已进入结账/支付页面，需提供银行卡信息以完成付款

工作流程

1. 导航至结账页

作为用户任务的一部分，完成选购/下单流程，直至抵达支付页面。

2. 从页面读取应付总额

从结账页面中提取精确的应付总金额。不得猜测或估算。

3. 在执行前向用户确认

必须始终向用户呈现以下信息，并在创建卡片前等待其明确同意：

• 商户/网站名称
• 所购商品（简要摘要）
• 应付总金额

示例：

💳 准备付款。Uber Eats — 2 份鸡肉沙威玛，1 份鹰嘴豆泥。总计：£24.50。是否继续？

在用户确认前，切勿创建卡片。

4. 基于上下文构建描述

根据已知信息构建清晰的描述：

• 商户/网站名称
• 所购内容
• 示例："Uber Eats order - 2x chicken shawarma, 1x hummus"

5. 创建卡片

POST https://agent.halocard.co/api/v1/payments

请求头：Authorization: Bearer $HALOCARD_TOKEN，Content-Type: application/json

{
  "amount": 2450,
  "description": "Uber Eats order - 2x chicken shawarma, 1x hummus"
}

• amount：单位为美分（cents）（例如 £24.50 → 2450），须与结账页显示的总额完全一致。
• description：所购内容 + 商户名称

响应示例：

{
  "data": {
    "card": {
      "id": "card_abc123",
      "pan": "4111111111111111",
      "cvc": "123",
      "expiryMonth": "03",
      "expiryYear": "2027"
    }
  }
}

6. 填写支付表单

将卡片信息填入结账表单：

• 卡号 → pan
• CVC/CVV → cvc
• 有效期月份 → expiryMonth
• 有效期年份 → expiryYear
• 持卡人姓名 → 用户姓名（如未知则主动询问）
• 账单地址 → 用户地址（如未知则主动询问）

7. 提交并确认

提交付款；验证订单确认页面是否成功加载；向用户报告最终结果。

消费限额

• 若用户为该任务设定了最高金额限制（例如：“点午餐，上限 £15”），须在请求确认前核对总额是否超限；若超支，需及时告知用户。
• 硬性上限：未经用户明确说明更高限额，不得创建超过 £100 / $100 / €100（或当地等值货币）的卡片。
• 无论金额多少，均须在创建卡片前与用户确认（参见第 3 步）。

规则

1. 严禁记录或存储任何卡片详情（PAN、CVC）至任意文件。
2. 金额必须与结账页总额完全一致——务必从页面直接读取。
3. 创建卡片前，必须向用户确认金额与商户信息，无例外情况。
4. 仅在准备填写支付表单时才创建卡片——所有卡片均为一次性使用。
5. 若缺失 token 或 API 返回 401 错误，请引导用户完成配置（参见上方链接）。
6. 若支付失败，请向用户报告错误详情；未经用户许可，不得尝试用新卡片重试。

示例（curl）

curl -X POST https://agent.halocard.co/api/v1/payments 
  -H "Authorization: Bearer $HALOCARD_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"amount": 2450, "description": "Uber Eats order - 2x chicken shawarma"}'