Yol Haritası
Cüzdan API'sindeki her yetenek dokümante edilmiştir; ama hepsi bugün üretimde çalışmaz. Bu sayfa ikisini net ayırır, böylece entegrasyon planınızı gerçeğe göre yaparsınız.
🚧 işaretli yetenekler için API sözleşmesi tamamlanmış ve kararlıdır — alan adları, durum makinesi ve hata kodları değişmeyecek şekilde tasarlandı. Eksik olan kod değil, o entegrasyonun ucundaki bağlı sağlayıcıdır (banka, fatura kurumu, ATM ağı, kart ihraççısı).
Bugün üretimde çalışanlar
Bu yetenekler kapalı devre içinde uçtan uca çalışır ve entegrasyonunuzu bugün bunlar üzerine kurabilirsiniz.
| Yetenek | Sayfa |
|---|---|
| Program, marka, para birimi ve politika yönetimi | Panel — Programlar |
| Son kullanıcı yaşam döngüsü, cüzdan ve hesap açma | Temel Kavramlar |
| Kart ile bakiye yükleme (3D Secure dahil) | Bakiye Yükleme |
| Temsilci (bayi) eliyle nakit yükleme | Bakiye Yükleme |
| Cüzdandan cüzdana transfer | Transfer |
| Cüzdanla ödeme — bireysel → işletme, komisyonlu | Cüzdanla Ödeme |
| Kart ödemesinin cüzdana iadesi | Cüzdana İade |
| QR üretme, okuma, tahsilat (kapalı devre) | QR |
| Cashback kampanyaları, puan, seviye, rozet | Sadakat & Cashback |
| Limit sayaçları ve KYC seviyesine bağlı yetki | Limitler · KYC Seviyeleri |
| Ücret şemaları ve quote | Ücretler |
| Operasyon listeleme, dekont, export | Operasyonlar |
| Webhook teslimatı | Webhook'lar |
| White-label son kullanıcı portalı | Portal |
Bağlı sağlayıcı bekleyenler
| Yetenek | Ne gerekiyor | Sayfa |
|---|---|---|
| 🚧 Havale/EFT ile yükleme | Bir banka entegrasyonu — kullanıcıya özel yatırma referansı ve gelen para eşleştirmesi bu entegrasyonun üzerinde çalışır | Bakiye Yükleme |
| 🚧 Bankaya çekim (kendi IBAN'ına) | Aynı banka entegrasyonu | Para Çekme |
| 🚧 IBAN'a transfer (üçüncü şahsa) | Aynı banka entegrasyonu | Transfer |
| 🚧 Toplu ödeme | Aynı banka entegrasyonu (cüzdan içi hedefler hariç) | Toplu Ödeme |
| 🚧 Fatura ödeme | Fatura kurumu (biller) entegrasyonu — sorgulama ve ödeme mutabakatı sağlayıcıya bağlıdır | Fatura & Fatura Ödeme |
| 🚧 ATM / QR ile nakit çekim | Nakit çekim ağı bağlantısı | Para Çekme |
| 🚧 Kart ihracı | Kart ihraççısı (issuer-processor) ve BIN tahsisi | Panel — Kartlar |
🚧 entegrasyonlar sizin programınızda program yapılandırmasıyla kapalıdır — kapalı bir entegrasyonu çağırmak reddedilir. En baskın kapı programın loopMode alanıdır: varsayılan CLOSED ve bu durumda IBAN'a çekim, bankaya çekim ve IBAN hedefli toplu ödeme kalemleri koşulsuz reddedilir. Kart ihracı için ayrıca programınıza bir kart ihraççısı entegrasyonu bağlı olmalıdır; bağlı değilse tüm kart akışı reddedilir.
Sağlayıcı sözleşmeniz hazır olana kadar panelden Test entegrasyonlarını bağlayabilirsiniz (Test Bankası, Test ATM Ağı, Test Fatura Kurumu, Test Kart İhraççısı, Test Borsa) — deterministik simülatörlerdir, tüm senaryoları koşulsuz açıktır ve gerçek entegrasyonla aynı şekilde bağlanır. Böylece hata yollarını gerçek bir kuruma bağlanmadan sınarsınız. Senaryo tabloları: Test Etme.
Bu ayrımı ürünüzde de kurun: bir entegrasyonun kapalı olması "yetenek yok" değil, "bu program için açılmamış" demektir. Arayüzünüzde kapalı yolları gizlemeyin, kilitli gösterin — kullanıcı neyin ne zaman geleceğini görebilsin.
QR ve karşılıklı çalışabilirlik
QR bugün kapalı devre çalışır: ürettiğiniz kod sizin ekosisteminizde (kendi uygulamanız, kendi işletmeleriniz, kendi terminalleriniz) okunur ve ödenir.
Banka ve diğer ödeme uygulamalarının okuyabileceği ortak standart QR formatı henüz üretilmemektedir. Bunun sebebi teknik değil düzenleyicidir: hangi teknik rehberin geçerli olduğu ve alan yapısının nasıl olacağı netleşmeden bir format üretmek, "uyumlu sanılan ama hiçbir okuyucunun anlamadığı" bir kod doğurur. Bu netleşene kadar standart uyumu iddia edilmez.
Ayrıntı: QR.
Entegrasyonunuzu nasıl planlamalısınız
- Kapalı devre ile başlayın. Kullanıcı oluşturma, kart yükleme, transfer, ödeme ve sadakat bugün çalışır — ürünüzün çekirdeğini bunlarla kurun.
- 🚧 yeteneklerin sözleşmesine göre yazın. Alan adları ve durum makinesi kararlıdır; entegrasyon bağlandığında kodunuzu değiştirmeniz gerekmez.
- Kullanıcı arayüzünüzü koşullu kurun. "Bankaya çek" düğmesini program yeteneğine göre gösterin; kullanıcıya çalışmayan bir yol açmayın.
- Webhook'ları baştan bağlayın. Entegrasyon bağlandığında yeni olay tipleri aynı endpoint'ten akmaya başlar.
Bu sayfa nasıl güncellenir
Bir sağlayıcı bağlandığında ilgili sayfadaki 🚧 kutusu kaldırılır ve yetenek yukarıdaki "çalışanlar" tablosuna taşınır. Sürüm notları için Sürüm Notları.