Uygulamanız ödeme, iade veya desteklenen başka bir operasyonu başlatır.
Geliştirici rehberi
Senkron komutlar. Asenkron finansal sonuçlar.
Finansal operasyonlar ilk isteğin yanıtından sonra da devam edebilir. İşlemi başlatmak için komutları, sonraki sistemleri bilgilendirmek için olayları ve güncel operasyonel durumu almak için durum sorgularını kullanın; uygulamanızı sağlayıcıya özgü geri çağrı biçimlerine bağlamayın.
01Komut
02İlk yanıt
03Sağlayıcı işlemi
04Olay
05Durum sorgusu
Entegrasyon sınırı
Olaylar sağlayıcı karmaşıklığını değil, yaşam döngüsü değişikliklerini taşır
Uygulamalar her banka, PSP, acquirer veya terminal sağlayıcısının geri çağrı modelini öğrenmek yerine olayın ticari anlamına tepki vermelidir. Platform sınırı sağlayıcıya özgü tamamlanma davranışını daha istikrarlı bir entegrasyon modelinin arkasında tutar.
Senkron yanıt operasyonu ve o andaki durumunu tanımlar.
Kimlik doğrulama, terminal aktivitesi veya sağlayıcı işlemi asenkron devam edebilir.
Yaşam döngüsündeki değişiklik tepki vermesi gereken sistemlere iletilir.
Tüketen sistem güncel ve yetkili operasyonel duruma ihtiyaç duyduğunda mevcut durumu sorgulayabilir.
Kanıtlanmış model
Anlamsal olay modelleri
Üretim entegrasyonu deneyimi, online ödemeler ve diğer ödeme yöntemlerinde durum değişikliği ve tamamlanma bildirimlerinin değerini gösterir. Tekrar kullanılabilir olan unsur sağlayıcıya özgü olay adı değil, anlamsal yaşam döngüsüdür.
- Ödeme durumu değişti — operasyon yeni bir ödeme durumuna geçti.
- Kimlik doğrulama tamamlandı — müşteri doğrulama adımı bir sonuca ulaştı.
- İade güncellendi — ödeme sonrası düzeltme yeni bir duruma geçti.
- Terminal veya kanal operasyonu tamamlandı — asenkron kanal akışı bir sonuca ulaştı.
Kavramsal olay zarfı — güncel webhook şeması değildir
{
"event": "semantic-lifecycle-event",
"transaction_id": "durable-transaction-id",
"reference": "your-business-reference",
"state": "...",
"occurred_at": "..."
}Uygulama modeli
Entegrasyon rehberliği
Bu modeller üretim sistemlerinde kanıtlanmış entegrasyon davranışlarını açıklar. Teknik modeli tanımlar; güncel Zopio API'sinin belirli bir endpoint adı, alan adı veya sözleşme biçimini kullanacağına dair taahhüt değildir.
Olayları bildirim olarak ele alın
Olayı, iş mantığını sağlayıcı geri çağrı biçimine bağlamadan sonraki sistemlerde aksiyon başlatmak için kullanın.
İşlem kimliğini koruyun
Her asenkron güncellemeyi aynı kalıcı işlem kimliğine bağlı tutun.
Güncel durum önemliyse sorgulayın
İş akışı en güncel operasyonel gerçeğe ihtiyaç duyduğunda yalnızca tek bir geri çağrıya güvenmek yerine durum sorgusu kullanın.
Tekrara dayanıklı tüketiciler tasarlayın
Sonraki sistemler daha önce işlenen yaşam döngüsü güncellemelerini tanıyabilmeli ve aynı ticari aksiyonu iki kez çalıştırmamalıdır.
Kanal farklarını sınırın arkasında tutun
Online, terminal ve alternatif ödeme akışları farklı sağlayıcı davranışları gösterebilir; entegrasyon ilkeleri ortak kalabilir.
İncelemeye devam edin
Entegrasyonunuzu konuşalım