Dashboard Operasyonları
Dashboard'da Transactions (payment), Charges, Payment Methods ve operasyonel inceleme rehberi.
Dashboard, ödeme operasyonunda tek kayıt etrafında bağlam toplar. Menüde Transactions görünür; API ve domain modelinde bu kayıtlar payment'tır. Charges sağlayıcı denemeleridir; bir payment altında birden fazla charge normaldir (routing fallback, yeniden confirm).
Bu sayfa mevcut ekranlara göre yazılmıştır; listede olmayan alarm veya raporlama özelliklerini varsaymayın.
Sidebar (sol menü)
Menü grupları ve kalemler dashboard sol menüsünde sabittir. Aşağıdaki Yüzey sütunu, arayüzde gördüğünüz sidebar etiketidir (Türkçe). Detay ekranları sidebar'da ayrı kalem değildir; ilgili listeden satıra tıklayarak veya global aramadan açılır.
Global arama (command palette): payment, charge, refund ve payment method kimliklerine gider.
Dashboard grubu
| Yüzey | Ne için kullanılır? | Operasyonel değer |
|---|---|---|
| Dashboard | Ana özet ekranı | Günlük KPI ve kısa yönlendirme; derin incident analizi için yeterli değil |
| Katalog | Ürün kataloğu (planlanan) | Şu an yapım aşamasında |
| Müşteriler | Hesap müşteri listesi ve kayıt | Payment'taki customer_id ile eşleştirme, müşteri bağlamı |
| İşlemler | Payment listesi (API: payments) | Operasyonun ana girişi; listeden payment detayına geçiş |
Ödemeler grubu
| Yüzey | Ne için kullanılır? | Operasyonel değer |
|---|---|---|
| Tahsilatlar | Tüm charge attempt listesi | Decline, provider ve işlem referansı (RRN / provider order id) taraması |
| Ödeme Yöntemleri | Kayıtlı kart/token hub'ı | Attach/detach, guest bağlamı, save preference; payment detayındaki method kartı ile aynı model |
| Ödeme Oturumları | Checkout session listesi | Hosted checkout kaynaklı payment'ları session ID ile bulma |
| İtirazlar | Chargeback / dispute (planlanan) | Şu an yapım aşamasında |
Faturalama grubu
| Yüzey | Ne için kullanılır? | Operasyonel değer |
|---|---|---|
| Abonelikler | Tekrarlayan faturalama (planlanan) | Şu an yapım aşamasında |
| Faturalar | Fatura listesi | Billing operasyonu (ödeme incident'i için ikincil) |
Sağlayıcılar grubu
| Yüzey | Ne için kullanılır? | Operasyonel değer |
|---|---|---|
| Sağlayıcılar | Platform sağlayıcı kataloğu | Hangi adapter'ların mevcut olduğu |
| Yapılandırmalar | Hesap bazlı provider config | Routing ve confirm'de hangi config'in seçildiğini payment/charge ile çapraz okuma |
Geliştiriciler grubu
| Yüzey | Ne için kullanılır? | Operasyonel değer |
|---|---|---|
| Api Anahtarları | API key oluşturma ve rotasyon | Entegrasyon ve yetki sorunları |
| Webhook'lar | Endpoint tanımı | Event aboneliği yapılandırması |
| Teslimatlar (Webhook alt menüsü) | Webhook delivery log | Payment event sheet'teki request_id / payload ile eşleştirme |
Ek Özellikler grubu
| Yüzey | Ne için kullanılır? | Operasyonel değer |
|---|---|---|
| Sanal Terminal | Manuel create + confirm | Sandbox kart, secure mode, guest/registered test; sonuç İşlemler detayında doğrulanmalı |
| Olaylar / Loglar | Merkezi event listesi (planlanan) | Şu an yapım aşamasında; canlı event'ler payment detayı Events kartında |
Sidebar dışı ama operasyonda sık kullanılan: üst çubuk hesap değiştirici (production / sandbox), Ayarlar (hesap üyeleri, sandbox hesapları).
Detay ekranları (sidebar'da yok, listeden açılır)
| Liste (sidebar kalemi) | Detay ekranı |
|---|---|
| İşlemler | Payment hub: lifecycle, charges, routing, payment method sekmeleri, events |
| Tahsilatlar | Charge detay: attempt details, technical JSON, payment / PM quick link |
| Ödeme Yöntemleri | Method detay: fingerprint, save preference, attach/detach |
| Ödeme Oturumları | Session detay: token, line items, bağlı payment |
İşlemler (Transactions) listesi
Liste, seçili hesaptaki payment'ları sayfalar. Satıra tıklayınca veya göz ikonuyla detaya gidilir.
Sütunlar: payment ID (kopyalanabilir kısa gösterim), tutar, status, müşteri (e-posta/ad/ID), charge sayısı, ilişkiler (charges / routing_plans / events özeti tooltip ile), oluşturulma zamanı.
Liste verisi: API çağrısı payment ile birlikte include_charges, include_routing_plans, include_events, include_customer ister; bu yüzden listeden detaya geçmeden de kaç charge ve event olduğu görülebilir.
Sayfalama: 10 / 25 / 50 / 100 satır.
İşlem detayı (payment hub)
Üst başlıkta payment status ve kısaltılmış ID görünür. Aşağıdaki kartlar sırayla operasyon incelemesine göre düzenlenmiştir.
Özet ve para
- Hero: Tutar, para birimi, status rozeti.
- Lifecycle: Payment status (merchant order state ile eşleştirin).
- Money: Charge'lardan toplanan authorized / captured / refunded toplamları; payment tutarıyla karşılaştırma için kullanılır.
Kimlik ve bağlam
- Fingerprints: Payment ID, account, checkout session ID, provider ve config referansları (kopyalanabilir); ilgili charge satırlarına link.
- Customer: Bağlı müşteri özeti.
- Checkout session: Payment'ta
checkout_session_idvarsa session kartı yüklenir (durum, token bağlamı).
Ödeme yöntemi (önemli)
Payment Methods kartı, bu payment'ta kullanılan yöntemleri charge attempt başına sekme ile gösterir (en yeni attempt üstte).
Sekme başına tipik alanlar:
- Kart tipi, method ID, network rozeti, status
- Çözümleme: network, brand, country, issuer, IIN, sağlayıcı adı
- Müşteri bağlamı:
customer_id, guest / non-guest, customer'a attach durumu - Parmak izi: primary / secondary fingerprint (varsa)
- Kaydetme tercihi: requested, planned, affected, failed (confirm sonrası kart kaydı planı)
Charge yoksa yalnızca payment method kayıtları; charge varsa öncelik charge sırasına göre sekmeler açılır.
Sağlayıcı ve denemeler
- Providers / Provider configs: Charge'larda geçen sağlayıcı ve config özetleri.
- KPI: Denenen sağlayıcı sayısı gibi kısa metrikler.
- Charges: Her attempt için status,
attempt_no, tutar, hata özeti (decline varsa), sağlayıcı/method adı; JSON önizleme (yan sheet) ve Charge detayına git (/charges/{id}).
Routing ve olaylar
- Routing plans: Plan ID,
current_index; hover'da mini akış önizlemesi; tam plan için yan sheet (React flow). - Events: Zaman çizelgesi; satıra tıklayınca event sheet:
trace_id,request_id,payment_id,charge_id,routing_plan_id,checkout_session_id, payload JSON. - Routing flow (tam genişlik): Birden fazla plan varsa sekmeli interaktif routing diyagramı (adaylar, sonuç düğümleri, charge eşlemesi).
Diğer
- Metadata: Merchant
metadataJSON.
Yan paneller (sheet)
Detay sayfasında satır içi kalmadan açılan paneller:
| Panel | İçerik |
|---|---|
| Event | Event adı, tracing alanları, ham payload |
| Routing plan | Plan özeti + mini flow |
| Charge | Kısa charge özeti; tam sayfaya geçiş butonu |
Tahsilatlar (Charges) listesi
Account kapsamındaki tüm charge attempt'ler.
Sütunlar: charge ID, tutar, status, payment ID (kısaltılmış), işlem referansı (transaction içinden provider_order_id veya rrn, düz transaction_id alanı yok), sağlayıcı adı, oluşturulma.
Satır tıklanınca charge detayına gider.
Tahsilat detayı
API: include_attempt_details=true ile zengin detay.
Kartlar:
| Kart | Amaç |
|---|---|
| Hero | Status, tutar, ID |
| Amounts | Authorized / captured / refunded kırılımı |
| Routing | routing_plan_id, routing_origin, attempt_no |
| Quick links | İlgili payment (/transactions/{payment_id}) ve payment method (/payment-methods/{id}) |
| Provider IDs | Sağlayıcı ve method kimlikleri |
| Snapshot | Özet attempt anlık görüntüsü |
| Network | transaction alt kümesi (RRN, provider order id vb.) |
| Security | Maskelenmiş security alt kümesi |
| Outcome | Decline / hata özeti |
| Attempt details | Adapter attempt detayları (varsa) |
| Technical | details, exchanges, metadata, performance JSON blokları |
Decline veya REQUIRES_ACTION analizi için bu ekran payment detayındaki charge listesinden daha derindir.
Ödeme Yöntemleri listesi
Hesaptaki kayıtlı ödeme yöntemleri (kart tokenları, guest checkout yöntemleri vb.).
Liste sütunları: ID, type, network, customer ID, guest/non-guest rozeti, status, kaydetme tercihi özeti (planned / affected), oluşturulma.
Satır aksiyonları (koşullu):
- Attach:
ACTIVE, guest değil, customer yoksa müşteriye bağlama diyaloğu - Detach: customer bağlıysa ayırma onayı
- Guest veya inactive yöntemlerde attach/detach kapalı
Detay ekranı:
- Temel bilgi: type, category, network, status, issuer, country
- Müşteri bağlamı + attach/detach butonları (kurallar liste ile aynı)
- Fingerprint primary / secondary
- Save preference bayrakları
- Ham
metadataJSON
Payment detayındaki method sekmeleri ile aynı veri modeli; hub ekranı tüm hesap yöntemlerini yönetmek içindir.
Önerilen inceleme sırası (incident)
- Sidebar İşlemler'den payment ID ile detayı açın.
- Lifecycle ve Money ile merchant state beklentisini kontrol edin.
- Charges kartında kaç attempt, hangi status (özellikle
DECLINED). - Payment Methods sekmesinde hangi kart/network/issuer ile denendiğine bakın.
- Routing + Routing flow ile fallback oldu mu anlayın.
- Events içinde
request_id/trace_idalın; webhook log ile eşleştirin. - Gerekirse Tahsilatlar detayına inin (charge satırı veya sidebar).
- Checkout kaynaklıysa Checkout session kartını doğrulayın.
Redirect veya Virtual Terminal sonucu tek başına kanıt sayılmamalı; bu ekranlardaki status ve webhook ile kapatın.
Sandbox hesap seçimi
Üst çubuktaki hesap seçicisi production ile bağlı sandbox hesapları arasında geçiş yapar. Transactions, Charges ve Payment Methods listeleri seçili hesabın verisini gösterir; sandbox sonucu canlı finansal garanti değildir.
Ekip odakları
| Ekip | Önce bakılacak yer |
|---|---|
| Support | İşlem detayı: lifecycle + customer + metadata |
| Operations | İşlem detayı charges + routing flow; Tahsilat detayı decline |
| Engineering | Event sheet (trace/request) + tahsilat technical JSON |
| Risk / fraud | Ödeme Yöntemleri + işlem detayı PM sekmeleri (guest, fingerprint) |