Platform

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.

Üzerinde çalıştığı yapılar

01

Altyapı katmanları

İstek kenardan kasaya kadar beş katmandan geçer. Her katmanın tek bir işi var.

Cloudflare ve CloudFront isteği karşılar, trafiği süzer ve API'ye iletir.

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.

  1. API

    Değişikliği kaydeder

  2. Olay kuyruğu

    Olay yazılır

  3. Genel işçi

    Gruplar halinde alır

  4. Webhook kuyruğu

    Gönderim sırası

  5. Webhook gönderici

    İmzalar ve gönderir

  6. Endpoint'iniz

    Sizin sunucunuz

Olay hata verirse
Bir olay 5 kez alınıp işlenemezse bekleme kuyruğuna ayrılır. Silinmez.
  1. 1. alım
  2. 2. alım
  3. 3. alım
  4. 4. alım
  5. 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

Gönderilen istek 0Oluşan ödeme 0
  • 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.

Abone olunabilen olaylarpayment.createdpayment.processingpayment.succeededpayment.failedcharge.createdcharge.capturedcharge.failedrefund.createdcheckout_session.createdcheckout_session.failedcustomer.createdcustomer.updated
teslimat günlüğü
  • POST /hooks/hsrcpay500deneme 1
  • 5 sn sonra yeniden denenir
  • POST /hooks/hsrcpay200deneme 2
  • SUCCEEDED

Her denemeden sonra bekleme uzar, gövde değişmez.

  1. 5s
  2. 10s
  3. 15s
  4. 30s
  5. 1m
  6. 2m
  7. 5m
  8. 10m
  9. 30m
  10. 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.

Gelen işİşlenen iş

Ş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.