CreditClaw — 专为 AI Agent 设计的虚拟卡

CreditClaw.com 为您提供由您的所有者控制的消费能力。您的所有者可从其自有 Visa/Mastercard 卡创建一张 虚拟卡（Virtual Card），设定消费限额，并将其与您绑定。当您需要付款时，即可基于该虚拟卡即时生成全新的卡号，并填写商家的支付表单。

基础 URL：https://creditclaw.com/api/v1

以下各端点路径中的 rail3 是字面量、固定路径段（代表“虚拟卡”功能通道），请勿将其替换为您自己的 bot ID。

安全性

• 所有请求均需携带：Authorization: Bearer （注册接口除外，该接口会返回您的 API 密钥）。
• 切勿将您的 API 密钥发送至 creditclaw.com 以外的任何域名，也切勿与他人共享——该密钥即您的身份凭证，可直接用于消费您所有者的资金。
• 务必在每次支付前即时生成全新的卡号。禁止跨交易重复使用或缓存卡号——提交支付表单后应立即丢弃所用卡号。
• 每张虚拟卡均内置消费限额，并由卡组织网络层面强制执行。您的所有者可随时冻结或撤销某张虚拟卡。

1. 注册（仅需一次）

若您已在先前会话中获得 CREDITCLAW_API_KEY，则已完成注册——请跳至第 3 步。请勿重复注册；否则将创建一个新 bot，需重新绑定。

curl -X POST https://creditclaw.com/api/v1/bots/register 
  -H "Content-Type: application/json" 
  -d '{
    "bot_name": "my-research-bot",
    "owner_email": "jonathan@example.com",
    "pairing_code": "483-921"
  }'

• bot_name 与 owner_email 为必填字段。pairing_code（来自您人类所有者的新手引导界面）可自动将其账户与您关联——如有该码，请始终提供。
• 若无配对码（pairing code），请不带该字段注册，并将响应中的 owner_verification_url 提供给您的人类所有者，以便其认领您。
• 请立即保存响应中的 api_key——该密钥无法再次获取。请将其存储于您平台的标准凭据存储位置（默认：环境变量 CREDITCLAW_API_KEY；OpenClaw： ~/.openclaw/.env），并在下次会话中加载使用。
• 限流策略：每 IP 每小时最多 3 次注册请求。

2. 您的所有者创建虚拟卡

仅您的所有者可在 https://creditclaw.com/virtual-cards 创建虚拟卡。每张虚拟卡均有独立的消费限额、有效期及绑定的 bot。该卡必须 已绑定至您本人 且状态为 active，您方可使用。若您当前无可使用的虚拟卡，请联系您的人类所有者——请勿轮询查询。

3. 查看您的虚拟卡列表

curl https://creditclaw.com/api/v1/bot/rail3/cards 
  -H "Authorization: Bearer $CREDITCLAW_API_KEY"

该接口返回您已绑定的虚拟卡，包含 card_id、card_name、status、is_frozen 及消费限额信息（limit_amount_cents 表示每个 limit_period 周期内的限额；若 intent_mode: "open" 则表示无上限）。请选择一张用于支付的 card_id——其 status 必须为 "active"，且 is_frozen 为 false。限额由卡组织网络强制执行，因此超限支付将自动被拒绝。

4. 支付：即时生成全新卡号

当您处于商家结账页面并准备付款时：

curl -X POST https://creditclaw.com/api/v1/bot/rail3/cards/vc_9d2f.../credentials 
  -H "Authorization: Bearer $CREDITCLAW_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "merchant": {
      "name": "Acme Books",
      "url": "https://acmebooks.com",
      "country_code": "US"
    }
  }'

merchant 请求体为可选字段，但强烈建议提供——使用真实商家名称与网站生成的卡号具有最高支付通过率。空对象（{}）亦可正常工作。

响应示例：

{
  "card_id": "vc_9d2f...",
  "card_number": "4111111111111111",
  "exp_month": "12",
  "exp_year": "2027",
  "cvc": "123",
  "cardholder_name": "Jonathan Miller",
  "credential_expires_at": "2026-08-13T15:20:00.000Z"
}

响应中可能额外包含辅助字段（如 credential_merchant、usage_notes），可安全忽略。

请使用以下方式填写商家支付表单：

• 如需填写收货地址？调用 GET /bot/shipping-addresses 可获取您所有者已保存的地址列表（以 Markdown 格式返回；若 address_count: 0 则表示尚未保存任何地址——请向您的人类所有者索取）。
• 多数情况下，卡信息输入框位于 iframe 内（如 Stripe、Shopify 等集成方案）——请与该 iframe 交互；提交按钮通常位于主页面上。
• 硬性中断场景：出现 CAPTCHA、3-D Secure 或 OTP 验证挑战时，请立即中止并通知您的人类所有者。切勿尝试绕过此类验证。
• 提交支付表单后，请立即丢弃本次生成的所有卡号。下一笔支付需重新调用生成接口。

提交之后：若支付成功 → 流程结束，请告知您的人类所有者您购买了什么；若被拒绝 → 立即中止并通知您的人类所有者；请勿重试已被拒绝的支付；若提交后页面卡死或报错 → 该笔扣款仍可能已成功执行；请勿再次生成卡号，而应立即通知您的人类所有者，由其核查银行卡账单。

错误响应