HsrcPay Genel Bakış
HsrcPay platformunun kapsamı, temel kaynakları ve entegrasyon sınırları.
HsrcPay, çoklu ödeme sağlayıcısı ve yöntemini tek bir API yüzeyi üzerinden yöneten bir ödeme orkestrasyon katmanı sağlar.
Temel Domain Kaynakları
- Hesap: işletme sınırı, para birimi ve kaynak sahipliği
- Müşteri: ödeme yapan kişi/kurum profili
- Ödeme (Payment): ödeme niyeti ve yaşam döngüsünün üst kaydı
- Tahsilat Denemesi (Charge): sağlayıcı tarafında yürüyen fiili işlem
- İade (Refund): tahsilat sonrası iade yaşam döngüsü
- Checkout Session: hosted ödeme deneyiminin oturum katmanı
Neden Payment ve Charge Ayrımı Var?
payment, iş tarafındaki tekil ödeme hedefini temsil eder.charge, bu hedefe ulaşmak için yapılan sağlayıcı denemelerini temsil eder.- Bu ayrım; akıllı yönlendirme, yeniden deneme ve başarısızlık analizi için kritik görünürlük sağlar.
Resource İlişkileri (Özet)
- Hesap -> Ödemeler, müşteriler, checkout oturumları, webhook uçları
- Ödeme -> Bir veya daha fazla tahsilat denemesi
- Tahsilat denemesi -> Ödeme yöntemi, sağlayıcı bağlamı, iade kayıtları
- Checkout oturumu -> Ödeme tamamlandığında ödeme kaydıyla ilişki kurar
Entegrasyon Sınırları
- Frontend dönüş URL'si tek başına nihai ödeme kanıtı değildir.
- Nihai ödeme kapanışı event/webhook veya sunucu tarafı kaynak sorgusu ile doğrulanmalıdır.
- Hassas ödeme verileri uygulama loguna yazılmamalı; metadata ile teknik izleme ayrıştırılmalı.