API de recharge de crédit Stripe pour agents intégrés

Introduction

L'API Agent Stripe Credit Top-Up permet à un agent IA de vérifier le solde de crédit API d'un compte et, dans les limites configurées par l'utilisateur, de débiter le mode de paiement Stripe enregistré du compte pour ajouter des crédits supplémentaires.

Cette API n'est pas de type x402. Cela nécessite un compte BuiltWith existant et une clé de facturation d'agent distincte. Pour les paiements USDC de base sans compte, utilisez le BuiltWith x402 payments page.

Les trois points de terminaison principaux sont hébergés sur payments.builtwith.com.

Avant qu'un agent puisse utiliser ces points de terminaison, l'utilisateur doit activer la facturation de l'API Agent et configurer les limites de dépenses sur https://payments.builtwith.com/agent-payment-api-config.

Après activation manuelle, les agents peuvent utiliser les alias de chemin mppx hérités pour les mêmes opérations de rechargement Stripe à l'adresse https://api.builtwith.com/mppx. Ces alias ne correspondent pas à un protocole x402 ou de vérification de paiement.

Authentification

Copiez la clé de facturation de l'agent (à portée distincte) depuis la page de configuration de facturation et envoyez-la dans l'en-tête d'autorisation. Les clés API BuiltWith générales et les jetons temporaires bw-device ne permettent pas d'acheter des crédits.

Authorization: Bearer YOUR_AGENT_BILLING_KEY

Le paramètre de requête KEY, désormais obsolète, est déprécié car les informations d'identification contenues dans les URL peuvent être conservées dans les journaux et l'historique du navigateur.

Les requêtes comportant une clé manquante, invalide ou désactivée renvoient une erreur HTTP 401. Les comptes dont la facturation est suspendue renvoient une erreur HTTP 403.

🤖 Invite de l'agent 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

Ces anciens chemins mppx servent de proxy à l'API de recharge de crédit Stripe par méthode enregistrée. Ils ne sont pas de type x402 et ne renvoient ni n'acceptent d'en-têtes de défi de paiement.

Découverte

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

Itinéraires

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 }

Envoyez la clé de facturation de l'agent concernée dans l'autorisation : Bearer et incluez une clé d'idempotence unique sur les achats.

GET /v1/billing/api-discovery — Solde créditeur

Renvoie le solde créditeur API actuel du compte.

Demande

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

Champs de réponse

Champ	Taper	Description
`credits_total`	`number`	Total des crédits jamais alloués au compte.
`credits_used`	`number`	Crédits consommés par les appels API à ce jour.
`credits_available`	`number`	Crédits disponibles restants (total moins utilisé). C'est ce que l'agent doit vérifier avant d'effectuer des appels API.

Exemple de réponse

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

GET /v1/billing/api-configuration — Limites de dépenses

Renvoie les limites de dépenses configurées et le montant de l'allocation mensuelle déjà utilisé. L'agent doit vérifier ces informations avant de tenter un achat afin d'éviter les demandes rejetées.

Demande

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

Champs de réponse

Champ	Taper	Description
`max_per_purchase`	`number`	Nombre maximal de crédits que l'agent peut acheter en une seule transaction.
`max_monthly`	`number`	Nombre maximal de crédits que l'agent peut acheter au cours du mois calendaire UTC en cours.
`monthly_purchased`	`number`	Crédits déjà achetés par l'agent ce mois-ci.
`monthly_remaining`	`number`	Combien de crédits supplémentaires puis-je acheter ce mois-ci avant d'atteindre la limite mensuelle ?
`cost_per_2000_credits_usd`	`number`	Coût en dollars américains pour un achat minimum de 2 000 crédits. Utilisez ce montant pour estimer le coût d'un achat prévu.

Exemple de réponse

{
  "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 — Acheter des crédits

Le paiement est débité du mode de paiement Stripe enregistré de l'utilisateur et son compte est immédiatement crédité. Cet achat est soumis aux limites par achat et mensuelles définies dans la configuration de facturation de l'API Agent.

Demande

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

Envoyer la clé de facturation de l'agent concernée en tant que Authorization: Bearer YOUR_AGENT_BILLING_KEY, et envoyez un unique Idempotency-Key. Réutilisez cette clé uniquement lors d'une nouvelle tentative d'achat identique.

Corps de la requête

Champ	Taper	Requis	Description
`credits`	`number`	Oui	Nombre de crédits à acheter par tranches fixes de 2 000. Ne doit pas dépasser `max_per_purchase` ou le reste de l'allocation mensuelle.

Réponse de succès (HTTP 200)

Champ	Taper	Description
`success`	`boolean`	`true`
`credits_purchased`	`number`	Crédits ajoutés au compte.
`cost_usd`	`number`	Montant facturé en USD.
`payment_id`	`string`	Identifiant Stripe PaymentIntent pour le rapprochement.
`credits_available`	`number`	Solde de crédit disponible mis à jour après l'achat.

Exemple de requête

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

{ "credits": 2000 }

Exemple de réponse positive

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

Réponses d'erreur

HTTP	Signification
400	Échec de la validation : clé d’idempotence manquante, crédits non fractionnés en 2 000, limite par achat dépassée ou limite mensuelle UTC dépassée.
401	Clé de facturation de l'agent manquante ou invalide. Comprend un défi d'authentification WWW.
402	Le paiement Stripe a échoué ou aucun mode de paiement n'est enregistré.
403	Une clé API générale a été fournie au lieu de la clé de facturation spécifique, ou la facturation du compte est suspendue.
409	La clé d'idempotence est encore en cours d'application ou a été utilisée précédemment avec des données d'entrée différentes.
405	Méthode non autorisée - le point de terminaison requiert une méthode POST.

Domaines spéciaux

Nous tenons à votre disposition deux listes utiles pour la recherche de domaines : les listes « Ignorer » et les listes « Construire avec un suffixe ».

Liste d'ignorés
TVoici notre liste interne de domaines que nous n'indexons pas. Ils sont soit bloqués, soit contiennent trop de technologies trompeuses, soit trop de sous-domaines avec du contenu généré par les utilisateurs.

BuiltWith Liste des suffixes
Ceci est basé sur le Liste publique des suffixes mais comprend de nombreuses entrées supplémentaires pour les entreprises avec des sous-domaines qui doivent être considérés comme des domaines de premier niveau. Cette liste nous offre une meilleure visibilité pour les sites Web internes, par exemple, elle amène northernbeaches.nsw.gov.au au niveau supérieur par rapport à nsw.gov.au.

Ignorer les domaines (XML, JSON or TXT)

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

Domaines de suffixe (XML, JSON or TXT)

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

Codes d'erreur

Notez que les messages d'erreur dans ce format ne peuvent pas être garantis, votre implémentation doit également considérer les codes de réponse non 200 comme des erreurs. La propriété Lookup sera nulle (json) ou non fournie (xml) si l'erreur est liée au serveur. Afficher tous les codes d'erreur potentiels bien formés.

Conditions d'utilisation

Notre conditions générales couvrir l'utilisation de toutes nos API.

En général, vous pouvez utiliser l'API pour améliorer votre produit de nombreuses façons. La seule limitation est que vous ne pouvez pas revendre les données en l'état ni fournir des fonctionnalités dupliquées à builtwith.com et ses services associés.