EnglishالعربيةEspañolFrançaisPortuguêsРусскийTürkçeTiếng Việt
Crypto Card AlKart al
Geliştiriciler · REST API v1

Kartları kendi kodunuzdan çıkarın

Sanal Visa ve Mastercard kartlarını HTTPS üzerinden oluşturun, yükleyin, dondurun ve kapatın. İstekler JSON formatındadır, gizli bir anahtarla doğrulanır ve kripto ile yüklediğiniz aynı USDT bakiyesini kullanır.

Temel URLhttps://usdtcryptocard.com/api/v1
Kimlik doğrulama
Bearer sk_live_…
Format
HTTPS üzerinden JSON
Endpoint'ler
15
Webhook'lar
HMAC-SHA256 ile imzalı

Giriş

API, panelin yaptığı her şeyi sunucunuzdan yapar. Çıkardığınız her kart ve yaptığınız her yükleme, kripto yatırımlarıyla beslediğiniz ve her zaman USDT olarak tutulan hesap bakiyenizden ödenir.

Tutarlar iki ondalık basamaklı ABD doları cinsindendir. Zaman damgaları UTC'de ISO 8601 formatındadır. Liste endpoint'leri page ve per_page ile sayfalanır.

  1. Bir anahtar oluşturunPanelinizde API erişimini açın ve bir anahtar üretin.
  2. Erişimi etkinleştirinE-postanızı onaylayın, ilk yatırımınızı yapın, ardından destekten API'yi etkinleştirmesini isteyin.
  3. İlk çağrıyı yapınSağdaki istekle bakiyenizi kontrol edin, ardından ilk kartınızı çıkarın.
İlk çağrı
İstek
curl https://usdtcryptocard.com/api/v1/wallet/balance \
  -H "Authorization: Bearer sk_live_..."
Yanıt200
{
  "balance": 1312.5,
  "currency": "USDT",
  "pending_deposits": 500,
  "cards_active": 8,
  "cards_total_balance": 2450
}

Kimlik doğrulama

Gizli anahtarınızı her isteğin Authorization başlığında Bearer token olarak gönderin. Anahtarlar sk_live_ ile başlar ve panelinizde, API erişimi bölümünde üretilir.

Anahtarı sunucunuzda tutun

Anahtara sahip olan herkes hesabınızdaki parayı hareket ettirebilir. Onu bir ortam değişkeninden yükleyin ve asla tarayıcı ya da mobil koda koymayın.

İlk isteğinizden önce

Yeni bir anahtar, hesap hazır olana kadar 403 döndürür. E-postanızı onaylayıp ilk yatırımınızı yapana kadar onboarding_incomplete, ardından destek API erişimini açana kadar api_not_enabled alırsınız. Bize yazın, etkinleştirelim.

Başlıklar
İstek
Authorization: Bearer sk_live_your_api_key
Content-Type: application/json
X-Idempotency-Key: 7c1e2f0a-retry-safe

Hatalar

2xx dışındaki her yanıt bir JSON gövdesiyle gelir: üzerine dallanabileceğiniz sabit bir hata kodu ve insanlar için yazılmış bir mesaj.

200
İstek başarılı
201
Kaynak oluşturuldu
400
Geçersiz parametreler
401
Eksik veya geçersiz API anahtarı
403
Anahtar geçerli, ancak bu hesapta API erişimi henüz açık değil
404
Kaynak bulunamadı
429
Hız sınırı aşıldı
error.json
Yanıt403
{
  "error": "api_not_enabled",
  "message": "Open a support ticket from your dashboard to enable API access."
}

Hız sınırları

Limitler API anahtarı başına sayılır. Birini aşarsanız 429 alırsınız: biraz bekleyin ve artan aralıklarla yeniden deneyin.

İstek / Dakika
1.000
Kart / Dakika
50
İstek / Saat
10.000
Kartlar

Kart Yönetimi

Her kartın kendi bakiyesi, limitleri ve yaşam döngüsü vardır; böylece bir kampanya, müşteri veya abonelik diğerini asla etkilemez.

POST/cards

Yeni sanal kart ver

Seçtiğiniz BIN üzerinde bir kart çıkarır ve aynı çağrıda bakiyenizden yükler.

İstek Gövdesi

bin_idstringzorunlu
BIN tanımlayıcısı (örn. 491653). Mevcut BIN'leri listelemek için GET /bins kullanın.
amountnumberzorunlu
USD cinsinden ilk yükleme, bakiyenizden alınır. En az $50; $1 kart çıkarma ücreti ayrıca tahsil edilir.
labelstringopsiyonel
Kart için özel etiket (maks 64 karakter)
spending_limitnumberopsiyonel
USD cinsinden aylık harcama limiti. Varsayılan BIN maksimumu.
allowed_categoriesstring[]opsiyonel
Kartın kullanılabileceği satıcı kategorileri, örneğin reklam veya yazılım. Diğer her şey reddedilir.
auto_freeze_atnumberopsiyonel
Bakiye bu tutarın altına düştüğünde otomatik dondur
metadataobjectopsiyonel
İç takibiniz için anahtar-değer çiftleri (maks 20 anahtar)
POST /v1/cards
İstek
curl -X POST https://usdtcryptocard.com/api/v1/cards \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "bin_id": "491653",
    "amount": 500,
    "label": "Meta Ads — Campaign 12",
    "spending_limit": 2000,
    "allowed_categories": [
      "advertising"
    ],
    "metadata": {
      "campaign": "fall_2026"
    }
  }'
Yanıt201
{
  "id": "card_8xK2m9Lp4q",
  "bin_id": "491653",
  "network": "visa",
  "last4": "2039",
  "status": "active",
  "balance": 500,
  "spending_limit": 2000,
  "label": "Meta Ads — Campaign 12",
  "allowed_categories": [
    "advertising"
  ],
  "auto_freeze_at": null,
  "metadata": {
    "campaign": "fall_2026"
  },
  "created_at": "2026-09-30T12:00:00Z",
  "expires_at": "2030-10-31"
}
GET/cards

Filtreler ve sayfalama ile tüm kartları listele

Kartlarınız, en yeniden eskiye.

Query Parametreleri

statusstringopsiyonel
Duruma göre filtreleactivefrozenterminated
bin_idstringopsiyonel
BIN'e göre filtrele
pageintegeropsiyonel
Sayfa numarası. Varsayılan: 1
per_pageintegeropsiyonel
Sayfa başına öğe (1-100). Varsayılan: 25
GET /v1/cards
İstek
curl https://usdtcryptocard.com/api/v1/cards?status=active&per_page=25 \
  -H "Authorization: Bearer sk_live_..."
Yanıt200
{
  "data": [
    {
      "id": "card_8xK2m9Lp4q",
      "bin_id": "491653",
      "network": "visa",
      "last4": "2039",
      "status": "active",
      "balance": 500,
      "spending_limit": 2000,
      "label": "Meta Ads — Campaign 12"
    }
  ],
  "page": 1,
  "per_page": 25,
  "total": 1
}
GET/cards/{card_id}

Kart özetini al (hassas veri olmadan)

Numarası ve CVV'si olmadan kart. Bunlara ihtiyacınız olduğunda detaylar endpoint'ini kullanın.

Yol parametreleri

card_idstringzorunlu
Kartı oluşturduğunuzda dönen kart kimliği.
GET /v1/cards/{card_id}
İstek
curl https://usdtcryptocard.com/api/v1/cards/card_8xK2m9Lp4q \
  -H "Authorization: Bearer sk_live_..."
Yanıt200
{
  "id": "card_8xK2m9Lp4q",
  "bin_id": "491653",
  "network": "visa",
  "last4": "2039",
  "status": "active",
  "balance": 500,
  "spending_limit": 2000,
  "label": "Meta Ads — Campaign 12",
  "created_at": "2026-09-30T12:00:00Z"
}
GET/cards/{card_id}/details

Tam PAN, CVV ve son kullanma tarihini al

Hassas Endpoint

Tam PAN, CVV ve son kullanma tarihini döndürür. PCI-hassas — asla şifrelenmemiş loglamayın veya saklamayın. 30 req/min sınırlı.

Yol parametreleri

card_idstringzorunlu
Kartı oluşturduğunuzda dönen kart kimliği.
GET /v1/cards/{card_id}/details
İstek
curl https://usdtcryptocard.com/api/v1/cards/card_8xK2m9Lp4q/details \
  -H "Authorization: Bearer sk_live_..."
Yanıt200
{
  "id": "card_8xK2m9Lp4q",
  "pan": "4916530000002039",
  "cvv": "123",
  "exp_month": 10,
  "exp_year": 2030
}
POST/cards/{card_id}/freeze

Kartı geçici olarak askıya al

Tüm işlemleri durdurur. Bakiye korunur. Kart daha sonra çözülebilir.

Yol parametreleri

card_idstringzorunlu
Kartı oluşturduğunuzda dönen kart kimliği.
POST /v1/cards/{card_id}/freeze
İstek
curl -X POST https://usdtcryptocard.com/api/v1/cards/card_8xK2m9Lp4q/freeze \
  -H "Authorization: Bearer sk_live_..."
Yanıt200
{
  "id": "card_8xK2m9Lp4q",
  "status": "frozen",
  "balance": 500
}
POST/cards/{card_id}/unfreeze

Donmuş kartı yeniden etkinleştir

Donmuş kartta işlemleri yeniden etkinleştirir. status: "active" ile kart nesnesini döndürür.

Yol parametreleri

card_idstringzorunlu
Kartı oluşturduğunuzda dönen kart kimliği.
POST /v1/cards/{card_id}/unfreeze
İstek
curl -X POST https://usdtcryptocard.com/api/v1/cards/card_8xK2m9Lp4q/unfreeze \
  -H "Authorization: Bearer sk_live_..."
Yanıt200
{
  "id": "card_8xK2m9Lp4q",
  "status": "active",
  "balance": 500
}
DELETE/cards/{card_id}

Kartı kalıcı olarak sonlandır

Geri Alınamaz İşlem

Kartı sonlandırmak kalıcıdır. Kalan bakiye anında cüzdanınıza döndürülür.

Yol parametreleri

card_idstringzorunlu
Kartı oluşturduğunuzda dönen kart kimliği.
DELETE /v1/cards/{card_id}
İstek
curl -X DELETE https://usdtcryptocard.com/api/v1/cards/card_8xK2m9Lp4q \
  -H "Authorization: Bearer sk_live_..."
Yanıt200
{
  "id": "card_8xK2m9Lp4q",
  "status": "terminated",
  "returned_to_wallet": 500
}
Yüklemeler

Kart Yükleme

Tek tek kartlardan fon ekleyin veya çekin. Fonlar cüzdan bakiyenizden gelir.

POST/cards/{card_id}/fund

Karta fon ekle

Bakiyenizden karta para aktarır. Hemen harcanabilir.

Yol parametreleri

card_idstringzorunlu
Kartı oluşturduğunuzda dönen kart kimliği.

İstek Gövdesi

amountnumberzorunlu
Bakiyenizden karta aktarılacak USD tutarı.
POST /v1/cards/{card_id}/fund
İstek
curl -X POST https://usdtcryptocard.com/api/v1/cards/card_8xK2m9Lp4q/fund \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 200
  }'
Yanıt200
{
  "card_id": "card_8xK2m9Lp4q",
  "card_balance": 700,
  "wallet_balance": 612.5
}
POST/cards/{card_id}/withdraw

Fonları cüzdana geri çek

Güncellenmiş kart ve cüzdan bakiyelerini döndürür.

Yol parametreleri

card_idstringzorunlu
Kartı oluşturduğunuzda dönen kart kimliği.
POST /v1/cards/{card_id}/withdraw
İstek
curl -X POST https://usdtcryptocard.com/api/v1/cards/card_8xK2m9Lp4q/withdraw \
  -H "Authorization: Bearer sk_live_..."
Yanıt200
{
  "card_id": "card_8xK2m9Lp4q",
  "card_balance": 0,
  "wallet_balance": 1312.5
}
İşlemler

İşlem Geçmişi

Kartlarınızdaki tüm işlemleri görüntüleyin. Yetkilendirmeleri, kapanışları, iadeleri ve reddedileni içerir.

GET/transactions

Filtrelerle tüm işlemleri listele

Tüm kartlarınızdaki provizyonlar, kesinleşen işlemler, iadeler ve reddedilenler, en yeniden eskiye.

Query Parametreleri

card_idstringopsiyonel
Karta göre filtrele
typestringopsiyonel
Yalnızca bu türdeki işlemleri döndürür.authorizationsettlementrefunddecline
fromstringopsiyonel
Başlangıç tarihi (ISO 8601)
tostringopsiyonel
Bitiş tarihi (ISO 8601)
pageintegeropsiyonel
Sayfa numarası. Varsayılan: 1
GET /v1/transactions
İstek
curl https://usdtcryptocard.com/api/v1/transactions?card_id=card_8xK2m9Lp4q \
  -H "Authorization: Bearer sk_live_..."
Yanıt200
{
  "data": [
    {
      "id": "txn_3fQ9w1Zk",
      "card_id": "card_8xK2m9Lp4q",
      "type": "settlement",
      "amount": 42.9,
      "currency": "USD",
      "fee": 0.3,
      "merchant": {
        "name": "SPOTIFY",
        "mcc": "4899"
      },
      "created_at": "2026-09-30T14:02:11Z"
    }
  ],
  "page": 1
}
Cüzdan

Cüzdan ve Yatırımlar

Hesap cüzdanınızı yönetin. Kripto yatırın, bakiyeleri kontrol edin ve gelen yatırımları takip edin.

GET/wallet/balance

Cüzdan bakiyesini ve istatistiklerini al

USDT olarak tutulan bakiyeniz ve kartlarınızda bekleyen tutar.

GET /v1/wallet/balance
İstek
curl https://usdtcryptocard.com/api/v1/wallet/balance \
  -H "Authorization: Bearer sk_live_..."
Yanıt200
{
  "balance": 1312.5,
  "currency": "USDT",
  "pending_deposits": 500,
  "cards_active": 8,
  "cards_total_balance": 2450
}
GET/wallet/deposit-address

Kripto yatırım adreslerini al

Kriptoyu nereye göndereceğiniz. Yatırımlar, ağ onayladığında USDT'ye çevrilir.

Query Parametreleri

currencystringopsiyonel
Yalnızca bu coin için adresi döndürür. Hepsini almak için boş bırakın.btcethsolusdtbnbtrxpolltcavaxarb
GET /v1/wallet/deposit-address
İstek
curl https://usdtcryptocard.com/api/v1/wallet/deposit-address?currency=usdt \
  -H "Authorization: Bearer sk_live_..."
Yanıt200
{
  "data": [
    {
      "currency": "usdt",
      "network": "ERC-20 (Ethereum)",
      "address": "0x9c4e…b71a"
    }
  ]
}
BIN'ler

BIN Seçimi

Kart çıkarabileceğiniz 9 BIN, ağ ve cüzdan desteğiyle birlikte.

GET/bins

Tüm mevcut BIN'leri listele

Ağ, kategori ve Apple Pay / Google Pay desteğiyle BIN kataloğu.

GET /v1/bins
İstek
curl https://usdtcryptocard.com/api/v1/bins \
  -H "Authorization: Bearer sk_live_..."
Yanıt200
{
  "data": [
    {
      "id": "471938",
      "network": "visa",
      "category": "ads",
      "3ds": true,
      "apple_pay": true,
      "google_pay": true
    },
    {
      "id": "553184",
      "network": "mastercard",
      "category": "ads",
      "3ds": true,
      "apple_pay": true,
      "google_pay": true
    }
  ],
  "total": 9
}
3D Secure

3D Secure Kimlik Doğrulama

3DS sorgularını ve OTP kodlarını alın. Tüm kartlar otomatik olarak 3DS 2.0'a kaydedilir.

GET/3ds

Bekleyen 3DS sorgularını listele

Tek kullanımlık kodlarıyla bekleyen 3D Secure doğrulamaları; böylece telefon olmadan ödemeyi tamamlayabilirsiniz.

GET /v1/3ds
İstek
curl https://usdtcryptocard.com/api/v1/3ds?status=pending \
  -H "Authorization: Bearer sk_live_..."
Yanıt200
{
  "data": [
    {
      "id": "3ds_m4n5o6p7",
      "card_id": "card_8xK2m9Lp4q",
      "merchant": "SPOTIFY",
      "amount": 9.99,
      "otp": "847291",
      "status": "pending",
      "expires_at": "2026-09-30T15:05:00Z"
    }
  ]
}
Webhooks

Webhooks ve Olaylar

Olaylar gerçekleştiğinde gerçek zamanlı bildirimler alın. Payload'lar HMAC-SHA256 ile imzalanır.

Mevcut Olaylar

card.created
Yeni kart verildi
card.frozen
Bir kart donduruldu
card.unfrozen
Bir kart çözüldü
card.terminated
Bir kart sonlandırıldı
card.funded
Karta fon eklendi
transaction.authorized
İşlem yetkilendirildi
transaction.settled
İşlem kapandı
transaction.declined
İşlem reddedildi
transaction.refunded
İade işlendi
3ds.challenge
3DS doğrulaması gerekli
deposit.pending
Kripto yatırım algılandı
deposit.confirmed
Kripto yatırım onaylandı

İmza Doğrulama

Her gönderim, endpoint'inizin gizli anahtarıyla HMAC-SHA256 kullanılarak imzalanır. Payload'a güvenmeden önce imzayı ham gövde üzerinden yeniden hesaplayın ve sabit sürede karşılaştırın.

verify
Kod
# Ham bir payload'ın imzasını yeniden hesaplayın
echo -n "$RAW_BODY" | openssl dgst -sha256 -hmac "$WEBHOOK_SECRET"
POST/webhooks

Webhook endpoint kaydet

Bir HTTPS endpoint'i ve alması gereken olayları kaydeder.

İstek Gövdesi

urlstringzorunlu
Olayları almak için HTTPS endpoint URL'si
eventsstring[]zorunlu
Abone olunacak olay adları. Hepsi için ["*"] kullanın.
secretstringopsiyonel
Özel imzalama gizli anahtarı. Boş bırakılırsa otomatik oluşturulur.
POST /v1/webhooks
İstek
curl -X POST https://usdtcryptocard.com/api/v1/webhooks \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/hooks/cards",
    "events": [
      "transaction.authorized",
      "3ds.challenge"
    ]
  }'
Yanıt201
{
  "id": "wh_5tLr8QaZ",
  "url": "https://example.com/hooks/cards",
  "events": [
    "transaction.authorized",
    "3ds.challenge"
  ],
  "secret": "whsec_…",
  "created_at": "2026-09-30T12:00:00Z"
}
Sanal Kart Çıkarma API Referansı | USDT Crypto Card