Panel — Kartlar
- Taban yol
/api/panel/v1/wallet/cards (+ /card-events)- Kimlik
- Panel oturumu (JWT).
/card-eventsaltındaki issuer webhook uçları ayrıca issuer imza doğrulamasından geçer — panel oturumunun YERİNE değil, ÜSTÜNE. - Yetki
- RBAC izin kodu:
wallet:card:read·wallet:card:operate·wallet:card:authorize - Çapraz yüzey
- Bu sayfadaki uçların s2s API'de karşılığı YOKTUR; kendi panelinizden çağıramazsınız. Bu yetenekler yalnız merchant panelde, panel oturumuyla kullanılabilir.
Cüzdan bakiyesine bağlı sanal veya fiziksel kart ihracı.
Kart yaşam döngüsü, otorizasyon işleme, limit rezervasyonu ve mutabakat akışları hazırdır. Üretimde çalışması için bir issuer-processor bağlantısı ve BIN tahsisi gerekmektedir.
Bu kategori gerçek kart numarası (PAN) üretir; bağlı bir issuer olmadan hiçbir kart basılmaz — sistem sessizce bir simülatöre düşmez, istek reddedilir. Durum: Yol Haritası.
Kart ihracı
POST /api/panel/v1/wallet/cards| Alan | Zorunlu | Açıklama |
|---|---|---|
programId | ✅ | |
endUserId | ✅ | Kart sahibi |
sourceWalletAccountId | ✅ | Kartın harcayacağı hesap |
currency | ✅ | |
cardType | — | Sanal / fiziksel |
cardholderNameRef | — | Kart üzerindeki isim referansı |
spendLimitScheme | — | Karta özel harcama limiti şeması |
Yaşam döngüsü
Kart, cüzdan hesabına bağlı olduğu için bakiyeyle birlikte çalışır: kart harcaması, bağlı hesaptan düşer.
| İşlem | Ne yapar |
|---|---|
| Dondur / çöz | Kartı geçici olarak kullanılamaz yapar |
| İptal | Kartı kalıcı olarak kapatır |
| Yeniden basım | Yeni kart üretir, eskisini kapatır |
Otorizasyon ve mutabakat
Kart otorizasyonu geldiğinde tutar cüzdan hesabında bloke edilir; ödeme kesinleştiğinde blokaj kesinleşir, iptal edilirse çözülür.
Otorizasyon anında limit rezervasyonu fail-closed çalışır: limit servisi kısa bir son tarih içinde cevap veremezse otorizasyon reddedilir. Bu, karşılıksız harcamayı engelleyen kasıtlı bir davranıştır.
Kısmi kesinleştirmede (otorize tutarın bir kısmının alınması) limit sayacı kesinleşen tutarı sayar; aradaki fark tutar sayacına geri verilir. Bkz. Limitler.
Süresi dolan otorizasyonlar otomatik olarak çözülür ve blokaj kalkar.
Issuer olayları
Kart ihraççısından gelen olaylar (otorizasyon, kesinleştirme, ters çevirme) imzalı bir webhook yüzeyi üzerinden alınır ve kart durumuna yansıtılır.
Canlıya alma ön koşulları
Kart ihracı, cüzdanın en çok dış bağımlılığı olan yeteneğidir:
- Issuer-processor sözleşmesi
- BIN tahsisi
- Kart üretim ve dağıtım süreci (fiziksel kart için)
- PCI ve uyum onayları
- Kart harcama limiti şemaları
- Kayıp/çalıntı kart operasyon süreci
- Mutabakat ve ters ibraz süreçleri
Bu ön koşullar tamamlandığında sponsor politikasında issuer ve BIN sponsoru tanımlanır (Panel — Programlar), ardından bu bölüm etkinleşir.