For integrations

Emissao programatica de cartoes

Gere uma seed unica, emita um cartao virtual em estado pending_top_up e receba um endereco de wallet para funding em uma unica chamada API.

Quick start Referencia API completa

REST JSON Seed auth Wallet de funding

Agent-issued

4719 38•• •••• ••••

Issued byseed_…

CreatedJust now

InstantaneoResposta JSON

SeedCredencial unica

Visa / MCSelecao de rede

WalletEndereco incluido

What you can build

Seis padroes para os quais esta API foi criada

Os endpoints sao a base; os padroes mostram o que os builders de agentes realmente colocam em producao.

Agentes autonomos de gasto

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.

Automacao de campanhas de ads

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.

Cartoes descartaveis 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.

Coleta 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.

Billing 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 e 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

Gere seed, cartao e wallet em 1 chamada

Este endpoint retorna uma seed unica, um cartao em estado pending_top_up e um endereco de wallet conforme o asset. Use X-Seed nas chamadas seguintes.

OpenAPI 3.1 /.well-known/openapi.json Plugin manifest /.well-known/ai-plugin.json Machine descriptor /.well-known/agent.json

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

Metadados de API legiveis por maquina

Use estes arquivos para descobrir endpoints, esquemas de request/response e headers de autenticacao.

Type	Path	Description
GET	/.well-known/openapi.json	OpenAPI specification for the REST API.
GET	/.well-known/ai-plugin.json	Plugin manifest (references the OpenAPI spec).
GET	/.well-known/agent.json	Machine descriptor (links to spec + docs).
GET	/llms.txt	Short integration overview and URLs.

API surface

Todos os endpoints de relance

Use a base URL https://cryptocardy.com/v1/api.

Method	Path	Description
GET	/v1/api	Generate a seed, return a card in `pending_top_up` state, and provide a funding wallet address. Optional query params: `card`, `asset`.

Security model

Acesso por seed, sem reset de senha

Sua seed e a credencial. Guarde-a com seguranca e envie-a no header X-Seed. Se voce perder a seed, o acesso nao pode ser restaurado.

Estado do cartao

Os cartoes sao retornados com card.state em pending_top_up, para que a integracao saiba que o cartao existe, mas precisa de funding antes da ativacao.

Comece a integrar em minutos

Use o quick start para gerar seed, cartao e wallet, depois siga a referencia da API para parametros e campos de resposta.

Ler quick start