For integrations

Emision programatica de tarjetas

Genera una seed unica, emite una tarjeta virtual en estado pending_top_up y recibe una direccion de wallet para funding en una sola llamada API.

REST JSON Auth por seed Wallet de funding
Visa
Agent-issued
4719 38•• •••• ••••
Issued byseed_…
CreatedJust now
InstantaneoRespuesta JSON
SeedCredencial unica
Visa / MCSeleccion de red
WalletDireccion incluida
What you can build

Seis patrones para los que se diseno esta API

Los endpoints son la base; los patrones son lo que los creadores de agentes realmente implementan.

Agentes de gasto autonomos

Agents that decide what to buy and execute the purchase without human approval. The API issues a fresh card per transaction, charges it, then deletes it — leaving no reusable payment surface in the wild.

Automatizacion de campanas publicitarias

Programmatic issuance of one BIN-471938 (Visa Business) card per Meta / Google / TikTok ad account. Rotate cards every 30-60 days to keep accounts clean.

Tarjetas desechables por usuario

Marketplaces or platforms that need a unique card per end-user transaction. Issue, charge, delete in under 10 seconds — no PCI scope, no card-storage burden.

Cosecha de free trials

Sign up to free trials at scale. Each trial gets a card with the minimum load; deletion before renewal blocks the auto-charge cleanly.

Facturacion SaaS por workspace

Multi-tenant agents that bill upstream SaaS (AWS, OpenAI, Cloudflare, GitHub) on a per-workspace card. Costs become attributable to the customer without leaking your master billing identity.

Workers de scraping y signup

Each worker requests a card via the API the moment it needs a payment surface, uses it for the intended action, then closes it. The $1.50 unit cost is a fraction of any alternative approach.

Quick start

Genera una seed, una tarjeta y una wallet en 1 llamada

Este endpoint devuelve una seed unica, una tarjeta en estado pending_top_up y una direccion de wallet segun el asset. Usa X-Seed en las solicitudes siguientes.

1. Generate (seed + card + wallet)

curl "https://cryptocardy.com/v1/api?card=visa&asset=BTC"
import json
import requests
r = requests.get(
    "https://cryptocardy.com/v1/api",
    params={"card": "visa", "asset": "BTC"},
).json()
print(json.dumps(r, indent=2))
const r = await fetch("https://cryptocardy.com/v1/api?card=visa&asset=BTC").then(r => r.json());
console.log(JSON.stringify(r, null, 2));
Integration files

Metadatos API legibles por maquina

Usa estos archivos para descubrir endpoints, esquemas de request/response y headers de autenticacion.

TypePathDescription
GET/.well-known/openapi.jsonOpenAPI specification for the REST API.
GET/.well-known/ai-plugin.jsonPlugin manifest (references the OpenAPI spec).
GET/.well-known/agent.jsonMachine descriptor (links to spec + docs).
GET/llms.txtShort integration overview and URLs.
API surface

Todos los endpoints de un vistazo

Usa la base URL https://cryptocardy.com/v1/api.

MethodPathDescription
GET/v1/apiGenerate a seed, return a card in pending_top_up state, and provide a funding wallet address. Optional query params: card, asset.
Security model

Acceso basado en seed, sin recuperacion por password

Tu seed es la credencial. Guardala de forma segura y enviala con el header X-Seed. Si la pierdes, el acceso no se puede restaurar.

Estado de la tarjeta

Las tarjetas se devuelven con card.state en pending_top_up, de modo que la integracion detecta que existe la tarjeta pero necesita fondos antes de activarse.

Empieza a integrar en minutos

Usa el quick start para generar seed, tarjeta y wallet, luego sigue la referencia API para parametros y campos de respuesta.

Leer quick start