Если вы создаёте агент или бэкенд, которому нужно тратить деньги, вам нужны карты, которые можно создавать и контролировать в коде. Это руководство подробно разбирает API карт Cryptocardium — та же поверхность доступна как REST для обычных сервисов и как MCP-сервер для LLM-агентов.
Аутентификация и разрешения
Каждый вызов аутентифицируется с помощью Bearer API-ключа, созданного в вашем дашборде. Ключи имеют разрешения, чтобы вы могли дать агенту ровно нужные полномочия — и ничего лишнего.
cards:issue— создавать новые карты.cards:fund— переводить баланс на карту.cards:read— читать данные карты и транзакции.cards:control— устанавливать лимиты, замораживать, закрывать.
Выпуск карты
Создайте виртуальную карту одним запросом. Выберите BIN, оптимизированный под задачу — реклама, SaaS, кошельки или премиальные расходы — и задайте метку, чтобы найти карту позже.
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
}Пополнение из криптовалюты
Новая карта начинает с нулевого баланса. Пополните её из баланса криптовалюты на вашем аккаунте — карта становится доступной для расходов на эту сумму немедленно.
curl -X POST https://cryptocardium.com/api/v1/cards/card_9f2a1c/fund \
-H "Authorization: Bearer ck_live_…" \
-d '{ "amount_usd": 200, "asset": "USDT" }'Установка контроля расходов
Ограничьте каждую карту перед передачей агенту. Лимиты и правила по торговцам соблюдаются в момент авторизации на стороне сервера.
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"] }'Сверка через вебхуки
Подпишитесь на события авторизации и проверяйте подпись при каждой доставке. Это синхронизирует ваш реестр и агента в реальном времени без опроса сервера.
// POST на ваш URL вебхука
{
"event": "authorization",
"card_id": "card_9f2a1c",
"amount_usd": 19.99,
"merchant": "Cloud API Inc",
"mcc": "5818",
"result": "approved"
}
// header: X-Signature: sha256=…Тот же процесс через MCP
Когда LLM-агент должен управлять картами самостоятельно, укажите MCP-клиенту адрес сервера вместо написания REST-клиента. Агент видит issue_card, fund_card и set_card_limits как нативные инструменты — инструкция по настройке приведена в руководстве по MCP-серверу.
Итоговый сценарий
Аутентифицируйтесь с помощью ключа с ограниченными разрешениями, выпустите карту, пополните её из криптовалюты, установите ограничения и ведите сверку через вебхуки. Это весь цикл, который нужен агенту для безопасных расходов. Откройте аккаунт и создайте первый ключ, чтобы попробовать.
