Agent Stripe Guthabenauflade-API

Einführung

Mit der Agent Stripe Credit Top-Up API kann ein KI-Agent den API-Guthabenstand eines Kontos überprüfen und, innerhalb der vom Benutzer festgelegten Grenzen, die gespeicherte Stripe-Zahlungsmethode des Kontos belasten, um weiteres Guthaben hinzuzufügen.

Diese API ist nicht x402-kompatibel. Es wird ein bestehendes BuiltWith-Konto und ein separat gültiger Agenten-Abrechnungsschlüssel benötigt. Für kontolose Basis-USDC-Zahlungen verwenden Sie die BuiltWith x402 payments page.

Alle drei primären Endpunkte werden gehostet auf payments.builtwith.com.

Bevor ein Agent diese Endpunkte nutzen kann, muss der Benutzer die Agent-API-Abrechnung aktivieren und Ausgabenlimits konfigurieren unter https://payments.builtwith.com/agent-payment-api-config.

Nach der manuellen Aktivierung können Agenten für dieselben Stripe-Aufladevorgänge die alten mppx-Pfadaliase verwenden. https://api.builtwith.com/mppx. Die Aliase sind kein x402- oder Payment-Challenge-Protokoll.

Authentifizierung

Kopieren Sie den separat gültigen Agenten-Abrechnungsschlüssel von der Abrechnungskonfigurationsseite und senden Sie ihn im Autorisierungsheader. Allgemeine BuiltWith-API-Schlüssel und temporäre bw-Gerätetoken können nicht zum Kauf von Guthaben verwendet werden.

Authorization: Bearer YOUR_AGENT_BILLING_KEY

Der Legacy-Abfrageparameter KEY ist veraltet, da Anmeldeinformationen in URLs in Protokollen und im Browserverlauf gespeichert werden können.

Anfragen mit einem fehlenden, ungültigen oder deaktivierten Schlüssel geben den HTTP-Statuscode 401 zurück. Konten, deren Abrechnung gesperrt ist, geben den HTTP-Statuscode 403 zurück.

🤖 KI-Agenten-Aufforderung

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

Diese älteren MPPX-Pfade fungieren als Proxy für die gespeicherte Stripe-Methode zur Guthabenaufladung. Sie sind nicht x402-konform und senden oder akzeptieren keine Payment-Challenge-Header.

Entdeckung

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

Routen

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 }

Senden Sie den Agent Billing Key mit Gültigkeitsbereich in Authorization: Bearer und fügen Sie einen eindeutigen Idempotenz-Schlüssel zu den Käufen hinzu.

GET /v1/billing/api-discovery — Guthaben

Gibt den aktuellen API-Guthabenstand des Kontos zurück.

Anfrage

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

Antwortfelder

Feld	Typ	Beschreibung
`credits_total`	`number`	Die dem Konto jemals zugewiesenen Gesamtguthaben.
`credits_used`	`number`	Bisher durch API-Aufrufe verbrauchte Guthaben.
`credits_available`	`number`	Verbleibendes nutzbares Guthaben (Gesamtguthaben minus verbrauchtes Guthaben). Dies sollte der Agent vor API-Aufrufen überprüfen.

Beispielantwort

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

GET /v1/billing/api-configuration — Ausgabenlimits

Gibt die konfigurierten Ausgabenlimits und den bereits verbrauchten Anteil des monatlichen Budgets zurück. Der Agent sollte dies vor jedem Kaufversuch prüfen, um abgelehnte Anfragen zu vermeiden.

Anfrage

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

Antwortfelder

Feld	Typ	Beschreibung
`max_per_purchase`	`number`	Maximale Kredite, die der Agent in einer einzelnen Transaktion erwerben darf.
`max_monthly`	`number`	Maximale Anzahl an Credits, die der Agent im laufenden UTC-Kalendermonat erwerben kann.
`monthly_purchased`	`number`	Guthaben, die der Agent in diesem Kalendermonat bereits erworben hat.
`monthly_remaining`	`number`	Wie viele Credits können diesen Monat noch erworben werden, bevor das monatliche Limit erreicht ist?
`cost_per_2000_credits_usd`	`number`	Kosten in US-Dollar für einen Mindestkauf von 2.000 Credits. Nutzen Sie diese Angabe, um die Kosten eines geplanten Kaufs abzuschätzen.

Beispielantwort

{
  "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 — Credits kaufen

Die hinterlegte Stripe-Zahlungsmethode des Nutzers wird belastet und das Konto sofort gutgeschrieben. Der Kauf unterliegt den in der Agent-API-Abrechnungskonfiguration festgelegten Kauf- und Monatslimits.

Anfrage

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

Senden Sie den eingeschränkten Agenten-Abrechnungsschlüssel als Authorization: Bearer YOUR_AGENT_BILLING_KEY, und senden Sie eine einzigartige Idempotency-Key. Verwenden Sie diesen Schlüssel nur dann wieder, wenn Sie denselben Kauf erneut versuchen.

Anfragetext

Feld	Typ	Erforderlich	Beschreibung
`credits`	`number`	Ja	Anzahl der zu erwerbenden Credits in festen Schritten von 2.000. Darf nicht überschreiten `max_per_purchase` oder dem verbleibenden monatlichen Taschengeld.

Erfolgsmeldung (HTTP 200)

Feld	Typ	Beschreibung
`success`	`boolean`	`true`
`credits_purchased`	`number`	Dem Konto wurden Guthaben hinzugefügt.
`cost_usd`	`number`	Der berechnete Betrag ist in US-Dollar angegeben.
`payment_id`	`string`	Stripe PaymentIntent-ID für den Abgleich.
`credits_available`	`number`	Aktualisierter verfügbarer Kreditbetrag nach dem Kauf.

Beispielanfrage

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

{ "credits": 2000 }

Beispiel einer erfolgreichen Antwort

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

Fehlermeldungen

HTTP	Bedeutung
400	Validierungsfehler – fehlender Idempotenzschlüssel, Guthaben nicht in 2000er-Schritten, Limit pro Kauf überschritten oder monatliches UTC-Limit verletzt.
401	Fehlender oder ungültiger Agenten-Abrechnungsschlüssel. Beinhaltet eine WWW-Authentifizierungsanforderung.
402	Die Zahlung mit Stripe ist fehlgeschlagen oder es ist keine gültige Zahlungsmethode hinterlegt.
403	Es wurde ein allgemeiner API-Schlüssel anstelle des bereichsspezifischen Abrechnungsschlüssels angegeben, andernfalls wird die Abrechnung des Kontos ausgesetzt.
409	Der Idempotenzschlüssel wird noch verarbeitet oder wurde zuvor mit anderen Eingaben verwendet.
405	Methode nicht zulässig - Endpunkt erfordert POST.

Spezielle Domänen

Wir führen für Sie zwei Listen, die Sie bei der Suche nach Domänen verwenden können: Ignorierlisten und BuiltWith-Suffixlisten.

Ignorierliste
TDies ist unsere eigene interne Liste von Domänen, die wir nicht indizieren. Sie sind entweder blockiert, enthalten zu viele irreführende Technologien oder zu viele Subdomänen mit benutzergenerierten Inhalten.

BuiltWith Suffixliste
Dies basiert auf der Öffentliche Suffixliste enthält aber viele zusätzliche Einträge für Unternehmen mit Subdomänen, die als Top-Level-Domänen betrachtet werden sollten. Diese Liste bietet uns eine bessere Sichtbarkeit für interne Websites, beispielsweise bringt sie northernbeaches.nsw.gov.au auf die oberste Ebene über nsw.gov.au.

Domänen ignorieren (XML, JSON or TXT)

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

Suffixdomänen (XML, JSON or TXT)

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

Fehlercodes

Beachten Sie, dass Fehlermeldungen in diesem Format nicht garantiert werden können. Ihre Implementierung sollte auch Antwortcodes ungleich 200 als Fehler betrachten. Die Lookup-Eigenschaft ist null (JSON) oder wird nicht bereitgestellt (XML), wenn der Fehler serverbezogen ist. Alle potenziellen wohlgeformten Fehlercodes anzeigen.

Nutzungsbedingungen

Unser Allgemeine Geschäftsbedingungen decken die Verwendung aller unserer APIs ab.

Sie können die API grundsätzlich nutzen, um Ihr Produkt auf vielfältige Weise zu verbessern. Die einzige Einschränkung besteht darin, dass Sie die Daten nicht unverändert weiterverkaufen oder doppelte Funktionen für builtwith.com und die zugehörigen Dienste bereitstellen dürfen.