For integrations

Emission programmatique de cartes

Generez une seed unique, emettez une carte virtuelle en etat pending_top_up et recevez une adresse de wallet de funding en un seul appel API.

Quick start Reference API complete

REST JSON Seed auth Funding wallet

Agent-issued

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

Issued byseed_…

CreatedJust now

InstantaneReponse JSON

SeedIdentifiant unique

Visa / MCSelection du reseau

WalletAdresse incluse

What you can build

Six modeles pour lesquels cette API a ete concue

Les endpoints sont la base; les modeles montrent ce que les builders d agents livrent vraiment.

Agents de depense autonomes

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.

Automatisation des campagnes publicitaires

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.

Cartes jetables par utilisateur

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.

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

Facturation SaaS par 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 et 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

Generez seed, carte et wallet en 1 appel

Cet endpoint renvoie une seed unique, une carte en etat pending_top_up et une adresse de wallet selon l asset. Utilisez X-Seed pour les requetes suivantes.

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

Metadonnees API lisibles par machine

Utilisez ces fichiers pour decouvrir les endpoints, schemas request/response et en-tetes d authentification.

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

Tous les endpoints en un coup d oeil

Utilisez la 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

Acces par seed, sans reset de mot de passe

Votre seed est l identifiant. Stockez-la de facon securisee et envoyez-la via l en-tete X-Seed. Si vous la perdez, l acces ne peut pas etre restaure.

Etat de la carte

Les cartes sont renvoyees avec card.state a pending_top_up, afin que l integration sache que la carte existe mais doit etre financee avant activation.

Commencez l integration en quelques minutes

Utilisez le quick start pour generer une seed, une carte et une wallet de funding, puis suivez la reference API pour les parametres et les champs de reponse.

Lire le quick start