Si vous construisez un agent ou un backend qui doit dépenser de l'argent, vous avez besoin de cartes que vous pouvez créer et contrôler par code. Ce guide parcourt l'API de carte Cryptocardium de bout en bout — la même surface est disponible en REST pour les services conventionnels et en tant que serveur MCP pour les agents LLM.
Authentification et portées
Chaque appel est authentifié avec une clé API Bearer créée dans votre tableau de bord. Les clés portent des portées pour que vous puissiez donner à un agent exactement le pouvoir dont il a besoin, et rien de plus.
cards:issue— créer de nouvelles cartes.cards:fund— transférer du solde sur une carte.cards:read— lire les détails de carte et les transactions.cards:control— définir des limites, bloquer, clôturer.
Émettre une carte
Créez une carte virtuelle en une seule requête. Choisissez un BIN adapté au cas d'usage — publicités, SaaS, portefeuilles ou dépenses premium — et donnez-lui un libellé pour la retrouver facilement.
curl -X POST https://cryptocardium.com/api/v1/cards \
-H "Authorization: Bearer ck_live_…" \
-H "Content-Type: application/json" \
-d '{ "type": "virtual", "brand": "visa", "label": "ads-agent" }'{
"id": "card_9f2a1c",
"brand": "visa",
"last4": "4417",
"status": "active",
"balance_usd": 0.00
}Approvisionner la carte en crypto
Une nouvelle carte démarre avec un solde nul. Approvisionnez-la depuis le solde crypto de votre compte — la carte est immédiatement utilisable jusqu'à ce montant.
curl -X POST https://cryptocardium.com/api/v1/cards/card_9f2a1c/fund \
-H "Authorization: Bearer ck_live_…" \
-d '{ "amount_usd": 200, "asset": "USDT" }'Définir les contrôles de dépenses
Limitez chaque carte avant de la confier à un agent. Les plafonds et les règles marchands sont appliqués au moment de l'autorisation, côté serveur.
curl -X POST https://cryptocardium.com/api/v1/cards/card_9f2a1c/limits \
-H "Authorization: Bearer ck_live_…" \
-d '{ "monthly_usd": 200, "daily_usd": 50, "mcc_allow": ["5818"] }'Réconcilier avec les webhooks
Abonnez-vous aux événements d'autorisation et vérifiez la signature à chaque livraison. Cela maintient votre registre comptable et votre agent synchronisés sans avoir à interroger l'API.
// POST vers votre URL de webhook
{
"event": "authorization",
"card_id": "card_9f2a1c",
"amount_usd": 19.99,
"merchant": "Cloud API Inc",
"mcc": "5818",
"result": "approved"
}
// en-tête : X-Signature: sha256=…Le même flux via MCP
Quand un agent LLM doit piloter les cartes lui-même, pointez un client MCP vers le serveur plutôt que d'écrire un client REST. L'agent voit issue_card, fund_card et set_card_limits comme des outils natifs — consultez le guide du serveur MCP pour la configuration.
Récapitulatif
Authentifiez-vous avec une clé à portée limitée, émettez une carte, approvisionnez-la en crypto, plafonnez-la et réconciliez les données via webhooks. C'est la boucle complète dont un agent a besoin pour dépenser de l'argent en toute sécurité. Ouvrez un compte et créez votre première clé pour l'essayer.
