For integrations

اصدار البطاقات برمجيا

انشئ seed فريدا واصدر بطاقة افتراضية بحالة pending_top_up واستلم عنوان wallet للتمويل في استدعاء API واحد.

Quick start مرجع API الكامل

REST JSON مصادقة seed Funding wallet

Agent-issued

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

Issued byseed_…

CreatedJust now

فورياستجابة JSON

Seedاعتماد فريد

Visa / MCاختيار الشبكة

Walletالعنوان مضمّن

What you can build

ستة انماط صممت هذه الـ API لها

الـ endpoints هي الاساس، اما الانماط فهي ما يبنيه مطورو الوكلاء فعليا.

وكلاء انفاق ذاتيون

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.

اتمتة حملات الاعلانات

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.

بطاقات مؤقتة لكل مستخدم

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.

تشغيل تجارب مجانية بكثافة

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

فوترة SaaS لكل 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.

عمال scraping و 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

انشئ seed وبطاقة وwallet في استدعاء واحد

يعيد هذا الـ endpoint seed فريدا وبطاقة بحالة pending_top_up وعنوان wallet حسب الـ asset. استخدم X-Seed في الطلبات التالية.

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

بيانات API قابلة للقراءة الالية

استخدم هذه الملفات لاكتشاف الـ endpoints ومخططات الطلب/الاستجابة وهيدر المصادقة.

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

كل الـ endpoints في نظرة واحدة

استخدم 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

وصول مبني على seed بدون استعادة كلمة مرور

الـ seed هو بيانات الاعتماد الخاصة بك. خزنه بامان وارسله عبر الهيدر X-Seed. اذا فقدته فلن يمكن استعادة الوصول.

حالة البطاقة

تعود البطاقات بقيمة card.state = pending_top_up حتى تعرف التكاملات ان البطاقة موجودة لكنها تحتاج تمويلا قبل التفعيل.

ابدأ التكامل خلال دقائق

استخدم البداية السريعة لتوليد seed وبطاقة وwallet ثم اتبع مرجع API لمعرفة المعلمات وحقول الاستجابة.

اقرأ البداية السريعة