API de recarga de crédito de Agent Stripe

Introducción

La API Agent Stripe Credit Top-Up permite que un agente de IA compruebe el saldo de crédito de la API de una cuenta y, dentro de los límites configurados por el usuario, cargue el método de pago Stripe guardado en la cuenta para añadir más crédito.

Esta API no es x402. Requiere una cuenta BuiltWith existente y una clave de facturación de agente con alcance independiente. Para pagos USDC base sin cuenta, utilice la BuiltWith x402 payments page.

Los tres puntos finales principales están alojados en payments.builtwith.com.

Antes de que un agente pueda utilizar estos puntos finales, el usuario debe habilitar la facturación de la API del agente y configurar los límites de gasto en https://payments.builtwith.com/agent-payment-api-config.

Después de la habilitación manual, los agentes pueden usar alias de ruta mppx heredados para las mismas operaciones de recarga de Stripe en https://api.builtwith.com/mppx. Los alias no son un protocolo x402 ni un protocolo de desafío de pago.

Autenticación

Copie la clave de facturación del agente (con ámbito independiente) de la página de configuración de facturación y envíela en el encabezado de autorización. Las claves API generales de BuiltWith y los tokens temporales de dispositivo bw- no pueden comprar créditos.

Authorization: Bearer YOUR_AGENT_BILLING_KEY

El parámetro de consulta KEY heredado está obsoleto porque las credenciales en las URL pueden conservarse en los registros y el historial del navegador.

Las solicitudes con una clave faltante, inválida o deshabilitada devuelven un error HTTP 401. Las cuentas con facturación suspendida devuelven un error HTTP 403.

🤖 Mensaje del agente de IA

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

Estas rutas mppx heredadas actúan como proxy para la API de recarga de crédito mediante el método savedStripe. No son x402 y no devuelven ni aceptan encabezados de desafío de pago.

Descubrimiento

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

Rutas

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 }

Envíe la clave de facturación del agente con ámbito en Autorización: Portador e incluya una clave de idempotencia única en las compras.

GET /v1/billing/api-discovery — Saldo acreedor

Devuelve el saldo de crédito API actual de la cuenta.

Pedido

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

Campos de respuesta

Campo	Tipo	Descripción
`credits_total`	`number`	Créditos totales asignados a la cuenta.
`credits_used`	`number`	Créditos consumidos por las llamadas a la API hasta la fecha.
`credits_available`	`number`	Créditos utilizables restantes (total menos créditos utilizados). Esto es lo que el agente debe verificar antes de realizar llamadas a la API.

Ejemplo de respuesta

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

GET /v1/billing/api-configuration — Límites de gasto

Devuelve los límites de gasto configurados y el importe del presupuesto mensual ya utilizado. El agente debe comprobar esta información antes de intentar realizar una compra para evitar que se rechacen las solicitudes.

Pedido

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

Campos de respuesta

Campo	Tipo	Descripción
`max_per_purchase`	`number`	Créditos máximos que el agente puede comprar en una sola transacción.
`max_monthly`	`number`	Cantidad máxima de créditos que el agente puede adquirir durante el mes calendario UTC actual.
`monthly_purchased`	`number`	Créditos ya adquiridos por el agente durante este mes calendario.
`monthly_remaining`	`number`	¿Cuántos créditos más se pueden comprar este mes antes de alcanzar el límite mensual?
`cost_per_2000_credits_usd`	`number`	Costo en USD para la compra mínima de 2000 créditos. Utilice este valor para estimar el costo de una compra planificada.

Ejemplo de respuesta

{
  "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 — Comprar créditos

Se realiza el cargo al método de pago Stripe guardado por el usuario y se abona inmediatamente en la cuenta. La compra está sujeta a los límites mensuales y por compra establecidos en la configuración de facturación de la API del agente.

Pedido

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

Enviar la clave de facturación del agente con ámbito Authorization: Bearer YOUR_AGENT_BILLING_KEY, y enviar un único Idempotency-Key. Utilice esa clave únicamente cuando vuelva a intentar realizar la misma compra.

Cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
`credits`	`number`	Sí	Número de créditos a comprar en incrementos fijos de 2000. No debe exceder `max_per_purchase` o la asignación mensual restante.

Respuesta exitosa (HTTP 200)

Campo	Tipo	Descripción
`success`	`boolean`	`true`
`credits_purchased`	`number`	Créditos añadidos a la cuenta.
`cost_usd`	`number`	Importe cobrado en USD.
`payment_id`	`string`	ID de Stripe PaymentIntent para la conciliación.
`credits_available`	`number`	Saldo de crédito disponible actualizado después de la compra.

Ejemplo de solicitud

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

{ "credits": 2000 }

Ejemplo de respuesta exitosa

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

Respuestas de error

HTTP	Significado
400	Error de validación: falta la clave de idempotencia, los créditos no están en incrementos de 2000, se ha superado el límite por compra o se ha incumplido el límite mensual UTC.
401	Falta la clave de facturación del agente o es inválida. Incluye un desafío de autenticación WWW.
402	El pago con Stripe falló o no hay ningún método de pago válido registrado.
403	Se proporcionó una clave API general en lugar de la clave de facturación específica, o bien se suspendió la facturación de la cuenta.
409	La clave de idempotencia aún está en desarrollo o se utilizó previamente con una entrada diferente.
405	Método no permitido: el punto final requiere POST.

Dominios especiales

Mantenemos dos listas útiles para la búsqueda de dominios: listas de ignorados y listas de sufijos incorporados.

Lista de ignorados
TEsta es nuestra lista interna de dominios que no indexamos. Están bloqueados, contienen demasiadas tecnologías engañosas o demasiados subdominios con contenido generado por el usuario.

BuiltWith Lista de sufijos
Esto se basa en la Lista de sufijos públicos pero incluye muchas entradas adicionales para empresas con subdominios que deberían considerarse dominios de nivel superior. Esta lista nos proporciona una mejor visibilidad para los sitios web internos, por ejemplo, lleva a northernbeaches.nsw.gov.au al nivel superior sobre nsw.gov.au.

Ignorar dominios (XML, JSON or TXT)

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

Dominios de sufijo (XML, JSON or TXT)

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

Códigos de error

Tenga en cuenta que no se pueden garantizar los mensajes de error en este formato; su implementación también debe considerar los códigos de respuesta distintos de 200 como errores. La propiedad Lookup será nula (json) o no se proporcionará (xml) si el error está relacionado con el servidor. Ver todos los posibles códigos de error bien formados.

Condiciones de uso

Nuestro términos estándar cubrir el uso de todas nuestras API.

En general, puede usar la API para mejorar su producto de diversas maneras. La única limitación es que no puede revender los datos tal cual ni proporcionar funcionalidad duplicada a builtwith.com y sus servicios asociados.