Sipariş, alacak, rezervasyon veya işletmenize ait başka bir kalıcı ticari referans.
Geliştirici rehberi
Ödeme tek bir API çağrısı değil, bir yaşam döngüsüdür.
İşletmenize ait referansı, ödeme kararını, sağlayıcı üzerinden yürütümü ve finansal sonucu; ilk işlem bilgisinden kimlik doğrulamaya, durum değişikliklerine, iptal veya iadeye kadar izlenebilir tek operasyon olarak birbirine bağlı tutun.
01Hazırla
02Simüle et
03Yürüt
04Kimlik doğrula
05Gözlemle
06Yönet
Entegrasyon sınırı
Yaşam döngüsü boyunca kalıcı kimlik
Entegrasyon işletmeye ait kalıcı bir referansla başlar ve sağlayıcı yürütümü ile sonraki finansal duruma bağlı kalabilen bir işlem kimliği üretir. Böylece ticari yükümlülük tek bir sağlayıcı isteğine bağlı hale gelmez.
Sağlayıcı ve kanal durumu değişirken operasyonu takip etmek için kullanılan platform düzeyinde kalıcı kimlik.
Yetkilendirme, kimlik doğrulama ve yürütüm sonuçları aynı işlem bilgisine bağlı kalır.
İptal, iade, hesaplaşma veya mutabakat gibi sonraki işlemler aynı yaşam döngüsünden devam edebilir.
Kanıtlanmış model
Yürütmeden önce önizleyin
Bir karar adımı, para hareket etmeden önce işlem bilgisini değerlendirebilir. Kanıtlanmış model; uygunluk ve yol seçimini yürütümden ayırarak işlem başlatılmadan önce seçilen yolun ve beklenen ekonominin değerlendirilebilmesini sağlar.
- Uygunluğu belirlemek için tutar, para birimi, müşteri veya hesap bilgisi ve ticari kuralları kullanın.
- Nihai ödeme çağrısından önce uygun sağlayıcıyı veya yürütüm yolunu değerlendirin.
- Beklenen işlem ekonomisini ve sağlayıcı seçimini kararın açıklanabilir bir parçası olarak koruyun.
- Yalnızca uygulamanın ihtiyaç duyduğu karar oluştuğunda yürütüme geçin.
Kavramsal nesne modeli — güncel API şeması değildir
{
"reference": "your-business-reference",
"payment_context": {
"amount": "...",
"currency": "...",
"channel": "..."
},
"transaction": {
"id": "durable-transaction-id",
"state": "..."
},
"decision": {
"eligible_path": "...",
"expected_economics": "..."
}
}Uygulama modeli
Yaşam döngüsü operasyonları
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.
Hazırla
Uygun ödeme deneyimini şekillendirmek için gereken ticari ve ödeme bilgisini oluşturun.
Simüle et
Yürütümden önce uygun yolu ve beklenen işlem ekonomisini değerlendirin.
Yürüt
Ödemeyi seçilen bağlantılı yol üzerinden başlatın.
Kimlik doğrula
Akış gerektiriyorsa sağlayıcının istediği müşteri kimlik doğrulama adımını tamamlayın.
Gözlemle
Mevcut sonucu anlamak için durum değişikliklerini, olayları ve durum sorgularını kullanın.
Yönet
Yaşam döngüsünü tamamlama, iptal, iade veya izin verilen başka bir sonraki aksiyonla sürdürün.
İncelemeye devam edin
Entegrasyonunuzu konuşalım