Para harcaması gereken bir ajan veya arka uç geliştiriyorsanız, kod üzerinden oluşturup yönetebileceğiniz kartlara ihtiyacınız var. Bu kılavuz, Cryptocardium kart API'sini baştan sona ele alır — aynı yüzey, geleneksel hizmetler için REST ve dil modeli ajanları için MCP sunucusu olarak kullanılabilir.
Kimlik doğrulama ve kapsamlar
Her çağrı, panonuzda oluşturulan bir Bearer API anahtarıyla doğrulanır. Anahtarlar kapsam taşır; böylece bir ajana tam olarak ihtiyacı olan yetkiyi ve fazlasını değil verebilirsiniz.
cards:issue— yeni kartlar oluştur.cards:fund— karta bakiye aktar.cards:read— kart detaylarını ve işlemleri oku.cards:control— limitler belirle, dondur, kapat.
Kart çıkarma
Tek bir istekle sanal kart oluşturun. Kullanım amacına uygun bir BIN seçin — reklamlar, SaaS, cüzdanlar veya premium harcama — ve daha sonra bulabilmek için etiket ekleyin.
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
}Kripto ile fonlama
Yeni bir kart sıfır bakiyeyle başlar. Hesabınızın kripto bakiyesinden fonlayın — kart o tutara kadar anında harcanabilir hale gelir.
curl -X POST https://cryptocardium.com/api/v1/cards/card_9f2a1c/fund \
-H "Authorization: Bearer ck_live_…" \
-d '{ "amount_usd": 200, "asset": "USDT" }'Harcama kontrolleri belirleme
Her kartı bir ajana vermeden önce sınırlayın. Limitler ve satıcı kuralları yetkilendirme anında sunucu tarafında uygulanır.
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"] }'Webhook'larla mutabakat
Yetkilendirme olaylarına abone olun ve her iletide imzayı doğrulayın. Bu, sorgu yapmadan defterinizi ve ajanınızı senkronize tutar.
// POST to your webhook URL
{
"event": "authorization",
"card_id": "card_9f2a1c",
"amount_usd": 19.99,
"merchant": "Cloud API Inc",
"mcc": "5818",
"result": "approved"
}
// header: X-Signature: sha256=…Aynı akış MCP üzerinden
Bir dil modeli ajanı kartları bizzat yönetmesi gerektiğinde, REST istemcisi yazmak yerine MCP istemcisini sunucuya yönlendirin. Ajan issue_card, fund_card ve set_card_limits'ı yerel araçlar olarak görür — kurulum için MCP sunucu kılavuzuna bakın.
Her şeyi bir araya getirmek
Kapsamlı anahtarla kimlik doğrulayın, kart çıkarın, kripto ile fonlayın, sınırlayın ve webhook'larla mutabakat sağlayın. Bu, bir ajanın güvenle para harcaması için ihtiyaç duyduğu döngünün tamamıdır. Hesap açın ve denemek için ilk anahtarınızı oluşturun.
