Agent Stripe充值API

登录报名 ✨ AI 代理人

介绍

代理 Stripe 充值 API 允许 AI 代理检查帐户的 API 信用余额，并在用户配置的限额内，从帐户保存的 Stripe 付款方式中扣款，以增加帐户信用额度。

此 API 不是 x402 接口。 它需要一个现有的 BuiltWith 帐户和一个单独作用域的代理计费密钥。对于无需帐户的 Base USDC 付款，请使用 BuiltWith x402 payments page.

所有三个主要端点都托管在 payments.builtwith.com.

代理要使用这些端点，用户必须启用代理 API 计费并配置消费限额。 https://payments.builtwith.com/agent-payment-api-config.

手动启用后，代理可以使用旧版 mppx 路径别名执行相同的 Stripe 充值操作。 https://api.builtwith.com/mppx. 这些别名不是 x402 或支付挑战协议。

验证

从计费配置页面复制单独作用域的代理计费密钥，并将其添加到 Authorization 标头中。通用 BuiltWith API 密钥和临时 bw 设备令牌无法购买积分。

Authorization: Bearer YOUR_AGENT_BILLING_KEY

旧版 KEY 查询参数已被弃用，因为 URL 中的凭据可能会保留在日志和浏览器历史记录中。

缺少、无效或禁用密钥的请求将返回 HTTP 401 错误。计费已暂停的帐户将返回 HTTP 403 错误。

🤖 AI代理提示

Reference https://api.builtwith.com/llms.txt and
https://raw.githubusercontent.com/builtwith/builtwith-ai-sdk/refs/heads/main/README.md
Add BuiltWith Agent Stripe Credit Top-Up API support to my app. This is saved-card
account billing, not x402. Check the account API-credit balance and, if below 1000,
purchase 2000 more using a unique Idempotency-Key and the scoped Agent Billing Key.
If the legacy mppx path aliases are desired, use
https://api.builtwith.com/mppx/openapi.json and the Agent Payment API routes
https://api.builtwith.com/mppx/api-discovery,
https://api.builtwith.com/mppx/api-configuration, and
https://api.builtwith.com/mppx/api-purchase.

mppx Stripe Credit Top-Up Path Aliases

这些旧版 mppx 路径代理已保存的 Stripe 充值方式 API。它们不是 x402 接口，也不返回或接受 payment-challenge 标头。

发现

GET https://api.builtwith.com/mppx/openapi.json

路线

GET https://api.builtwith.com/mppx/api-discovery

GET https://api.builtwith.com/mppx/api-configuration

POST https://api.builtwith.com/mppx/api-purchase

{ "credits": 2000 }

在授权方式中发送指定范围的代理计费密钥：持有者，并在购买时包含唯一的幂等密钥。

GET /v1/billing/api-discovery — 贷方余额

返回账户当前的 API 信用余额。

要求

GET https://payments.builtwith.com/v1/billing/api-discovery
Authorization: Bearer YOUR_AGENT_BILLING_KEY

响应字段

场地	类型	描述
`credits_total`	`number`	账户累计获得的信用额度。
`credits_used`	`number`	迄今为止，API 调用消耗的积分数量。
`credits_available`	`number`	剩余可用积分（总积分减去已用积分）。这是代理在发起 API 调用之前应该检查的内容。

示例回答

{
  "credits_total": 10000,
  "credits_used": 1234,
  "credits_available": 8766
}

GET /v1/billing/api-configuration — 消费限额

返回已配置的消费限额以及已使用的月度限额。代理商应在尝试购买前检查此信息，以避免请求被拒绝。

要求

GET https://payments.builtwith.com/v1/billing/api-configuration
Authorization: Bearer YOUR_AGENT_BILLING_KEY

响应字段

场地	类型	描述
`max_per_purchase`	`number`	代理人单笔交易可购买的最大信用额度。
`max_monthly`	`number`	代理人在当前 UTC 日历月内可购买的最大积分。
`monthly_purchased`	`number`	该代理商本月已购买的积分。
`monthly_remaining`	`number`	本月在达到月度限额之前还能购买多少积分？
`cost_per_2000_credits_usd`	`number`	最低2000积分购买的美元价格。请使用此价格估算计划购买的成本。

示例回答

{
  "max_per_purchase": 5000,
  "max_monthly": 20000,
  "monthly_purchased": 5000,
  "monthly_remaining": 15000,
  "cost_per_2000_credits_usd": 99.00
}

POST /v1/billing/api-purchase — 购买积分

系统会从用户保存的 Stripe 付款方式中扣款，并立即将款项记入账户。此次购买受代理 API 计费配置中设置的单次购买和每月限额的限制。

要求

POST https://payments.builtwith.com/v1/billing/api-purchase

发送指定范围的代理计费密钥 Authorization: Bearer YOUR_AGENT_BILLING_KEY, 并发送一个独特的 Idempotency-Key. 仅在重新尝试购买同一商品时才使用该密钥。

请求正文

场地	类型	必需的	描述
`credits`	`number`	是的	以 2,000 为单位购买固定数量的积分。不得超过 `max_per_purchase` 或剩余的月度津贴。

成功响应（HTTP 200）

场地	类型	描述
`success`	`boolean`	`true`
`credits_purchased`	`number`	账户已添加积分。
`cost_usd`	`number`	以美元计价的金额。
`payment_id`	`string`	Stripe PaymentIntent ID 用于对账。
`credits_available`	`number`	购买后更新可用信用余额。

示例请求

Authorization: Bearer YOUR_AGENT_BILLING_KEY
Idempotency-Key: 72b7b97c-3b6d-4c64-9bbf-20fd2a931514
Content-Type: application/json

{ "credits": 2000 }

成功回应示例

{
  "success": true,
  "credits_purchased": 2000,
  "cost_usd": 99.00,
  "payment_id": "pi_3abc123xyz",
  "credits_available": 10766
}

错误响应

HTTP	意义
400	验证失败 - 缺少幂等密钥、积分不是 2,000 的增量、单次购买限额已超出或 UTC 月度限额已超出。
401	缺少或无效的代理计费密钥。包含 WWW-Authenticate 验证。
402	Stripe支付失败或账户中没有可用的支付方式。
403	如果提供的是范围广泛的 API 密钥而不是限定范围的计费密钥，则帐户计费将被暂停。
409	幂等性密钥仍在开发中，或者之前曾用于不同的输入。
405	方法不允许 - 端点需要 POST 请求。

特殊域名

我们维护两个列表，供您在查找域名时使用。“忽略”列表和“BuiltWith 后缀”列表。

忽略列表
T这是我们内部不予索引的域名列表。这些域名要么被屏蔽，要么包含太多误导性技术，要么包含太多包含用户生成内容的子域名。

BuiltWith 后缀列表
这是基于公共后缀列表但对于拥有子域名的公司来说，还包括许多额外的条目，这些子域名应被视为顶级域名。此列表为我们提供了内部网站的更好可见性，例如，它将 northernbeaches.nsw.gov.au 置于 nsw.gov.au 之上。

忽略域 (XML, JSON or TXT)

https://api.builtwith.com/ignoresv1/api.json

后缀域 (XML, JSON or TXT)

https://api.builtwith.com/suffixv1/api.json

错误代码

请注意，这种格式的错误消息无法保证，您的实现也应该将非 200 响应代码视为错误。如果错误与服务器相关，则 Lookup 属性将为 null（json）或未提供（xml）。查看所有潜在的格式正确的错误代码.

使用条款

我们的标准条款涵盖我们所有 API 的使用。

一般来说，您可以使用 API 以多种方式增强您的产品。唯一的限制是您不能按原样转售数据，也不能向builtwith.com及其相关服务提供重复的功能。