HSRCPAY Dökümantasyon

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.

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üzeyNe için kullanılır?Operasyonel değer
DashboardAna ö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üşterilerHesap müşteri listesi ve kayıtPayment'taki customer_id ile eşleştirme, müşteri bağlamı
İşlemlerPayment listesi (API: payments)Operasyonun ana girişi; listeden payment detayına geçiş

Ödemeler grubu

YüzeyNe için kullanılır?Operasyonel değer
TahsilatlarTüm charge attempt listesiDecline, provider ve işlem referansı (RRN / provider order id) taraması
Ödeme YöntemleriKayıtlı kart/token hub'ıAttach/detach, guest bağlamı, save preference; payment detayındaki method kartı ile aynı model
Ödeme OturumlarıCheckout session listesiHosted checkout kaynaklı payment'ları session ID ile bulma
İtirazlarChargeback / dispute (planlanan)Şu an yapım aşamasında

Faturalama grubu

YüzeyNe için kullanılır?Operasyonel değer
AboneliklerTekrarlayan faturalama (planlanan)Şu an yapım aşamasında
FaturalarFatura listesiBilling operasyonu (ödeme incident'i için ikincil)

Sağlayıcılar grubu

YüzeyNe için kullanılır?Operasyonel değer
SağlayıcılarPlatform sağlayıcı kataloğuHangi adapter'ların mevcut olduğu
YapılandırmalarHesap bazlı provider configRouting ve confirm'de hangi config'in seçildiğini payment/charge ile çapraz okuma

Geliştiriciler grubu

YüzeyNe için kullanılır?Operasyonel değer
Api AnahtarlarıAPI key oluşturma ve rotasyonEntegrasyon ve yetki sorunları
Webhook'larEndpoint tanımıEvent aboneliği yapılandırması
Teslimatlar (Webhook alt menüsü)Webhook delivery logPayment event sheet'teki request_id / payload ile eşleştirme

Ek Özellikler grubu

YüzeyNe için kullanılır?Operasyonel değer
Sanal TerminalManuel create + confirmSandbox kart, secure mode, guest/registered test; sonuç İşlemler detayında doğrulanmalı
Olaylar / LoglarMerkezi 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ı
İşlemlerPayment hub: lifecycle, charges, routing, payment method sekmeleri, events
TahsilatlarCharge detay: attempt details, technical JSON, payment / PM quick link
Ödeme YöntemleriMethod 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_id varsa 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 metadata JSON.

Yan paneller (sheet)

Detay sayfasında satır içi kalmadan açılan paneller:

Panelİçerik
EventEvent adı, tracing alanları, ham payload
Routing planPlan özeti + mini flow
ChargeKı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:

KartAmaç
HeroStatus, tutar, ID
AmountsAuthorized / captured / refunded kırılımı
Routingrouting_plan_id, routing_origin, attempt_no
Quick linksİlgili payment (/transactions/{payment_id}) ve payment method (/payment-methods/{id})
Provider IDsSağlayıcı ve method kimlikleri
SnapshotÖzet attempt anlık görüntüsü
Networktransaction alt kümesi (RRN, provider order id vb.)
SecurityMaskelenmiş security alt kümesi
OutcomeDecline / hata özeti
Attempt detailsAdapter attempt detayları (varsa)
Technicaldetails, 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 metadata JSON

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)

  1. Sidebar İşlemler'den payment ID ile detayı açın.
  2. Lifecycle ve Money ile merchant state beklentisini kontrol edin.
  3. Charges kartında kaç attempt, hangi status (özellikle DECLINED).
  4. Payment Methods sekmesinde hangi kart/network/issuer ile denendiğine bakın.
  5. Routing + Routing flow ile fallback oldu mu anlayın.
  6. Events içinde request_id / trace_id alın; webhook log ile eşleştirin.
  7. Gerekirse Tahsilatlar detayına inin (charge satırı veya sidebar).
  8. 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
EngineeringEvent sheet (trace/request) + tahsilat technical JSON
Risk / fraudÖdeme Yöntemleri + işlem detayı PM sekmeleri (guest, fingerprint)

Bu sayfada