Arkada nasıl çalışıyoruz
Bir ödeme isteği kenardan girer, olay olarak kuyruğa düşer, işçilere dağılır ve webhook olarak size döner. Beş başlıkta, kısaca.
01
Altyapı katmanları
İstek kenardan kasaya kadar beş katmandan geçer. Her katmanın tek bir işi var.
Canlı ve sandbox ayrı
İki ortam ayrı veritabanında çalışır. Sandbox anahtarları _test_ içerir, test verisi canlıya karışmaz.
- Bölge
- Frankfurt (eu-central-1)
- Canlı
- Ayrı veritabanı
- Sandbox
- _test_Ayrı veritabanı
- Kart kasası
- İnternetten erişilemez
02
Olay yakalama
Her ödeme değişikliği bir olay olarak kuyruğa yazılır. İşlenemeyen olay silinmez, yeniden denenir.
API
Değişikliği kaydeder
Olay kuyruğu
Olay yazılır
Genel işçi
Gruplar halinde alır
Webhook kuyruğu
Gönderim sırası
Webhook gönderici
İmzalar ve gönderir
Endpoint'iniz
Sizin sunucunuz
- 1. alım
- 2. alım
- 3. alım
- 4. alım
- 5. alım
- Kuyruğa geri döner
- Bekleme kuyruğuna ayrılır
Kuyruktaki ve bekleme kuyruğundaki mesajlar 4 gün tutulur.
Zamanlayıcı 15 dakikada bir bekleyen teslimatları yeniden tetikler.
03
Tutarlılık
İstek ağda kaybolsa bile tekrar gönderebilirsiniz. Aynı Idempotency-Key ile gelen istek ilk sonucu döndürür.
Aynı isteği iki kez gönderin
İlk istek ödemeyi oluşturur, tekrarlar ilk sonucu döndürür.
POST /v1/payments
Idempotency-Key: order_8841
- Henüz istek gitmedi
Parmak izine ne girer
Anahtara ek olarak isteğin kendisi de karşılaştırılır. Yalnızca ödemeyi belirleyen alanlar parmak izine girer.
Karşılaştırılır
- Ödeme
- Kart ya da kayıtlı yöntem
- Yönlendirme stratejisi
Girmez
- CVV
- İsim
- IP adresi
Kilit süresi 2 dk
İlk istek işlenirken anahtar kilitli kalır, eşzamanlı ikinci istek ikinci ödemeyi açamaz.
Anahtar uzunluğu 1-255
Sizin ürettiğiniz herhangi bir değer. SDK, POST'u yalnızca anahtar varsa yeniden dener.
04
Webhook sistemi
Endpoint'iniz hata verirse teslimat bırakılmaz. Artan aralıklarla 10 kez denenir ve her denemede aynı gövde gider.
- POST /hooks/hsrcpay500deneme 1
- 5 sn sonra yeniden denenir
- POST /hooks/hsrcpay200deneme 2
- SUCCEEDED
Her denemeden sonra bekleme uzar, gövde değişmez.
- 5s
- 10s
- 15s
- 30s
- 1m
- 2m
- 5m
- 10m
- 30m
- 1h
05
Otomatik ölçekleme
Sabit sunucu yok. Yük arttıkça açılan kopyalar çalışır, ani artışı kuyruklar tamponlar.
Ani artışı kuyruk emer
Ani artışta iş kuyrukta bekler, işçiler sabit hızla alır.
Şematik gösterim, ölçüm değil.
Ölçeklemeyi sağlayan dört şey
Hiçbiri sizin ayarlamanızı gerektirmez.
İstek başına kopya
İstekler sabit bir sunucuya değil, gerektiğinde açılan kopyalara gider. Boşta kalan kopya kapanır.
Kuyruk tampon olur
Ani artışta işler kuyrukta bekler, işçiler sırayla alır. Kuyruk doldu diye iş kaybolmaz.
Hesap kotası
Bir hesabın yükü diğerlerini yavaşlatmasın diye her hesapta kota tavanı var.
Kontrollü hız
İşçilerin eşzamanlılığı bilerek sınırlı tutulur. Veritabanı ve ödeme sağlayıcıları aşırı yüklenmez.
Ayrıntılar dokümanda
İdempotency, webhook imzası ve olay tipleri için doküman sayfalarına bakın.