Tek işlem numarası
Oyuncuyu, tutarı, para birimini, ödeme yöntemini, ödeme sağlayıcısını ve tüm işlem geçmişini birbirine bağlar.
Dokümantasyon / Ödeme Akışı
Ödeme API'si nasıl çalışır
Ödeme yolunun tamamını inceleyin: para yatırma işleminin oluşturulması ve ödemenin onaylanmasından bakiyeye fon eklemeye, para çekmeye, iadelere ve finansal mutabakata kadar.
Para yatırma
oluşturma ve bakiyeye ekleme
Ödeme
doğrulama ve gönderim
Durumlar
işlem onayı
Mutabakat
finansal kontrol
Ödeme akışı
İstekten nihai sonuca
01
İşlemi oluşturun
Oyuncuyu, tutarı, para birimini, ödeme yöntemini ve benzersiz işlem numarasını kaydedin.
02
Ödemeyi onaylayın
Oyuncuyu ödeme sayfasına yönlendirin, banka onayı isteyin veya ödemeyi doğrudan işleyin.
03
Nihai durumu alın
Ödeme sağlayıcısının yanıtını kontrol edin ve işlemin nihai sonucunu onaylayın.
04
Bakiye ve muhasebeyi güncelleyin
Fonları bir kez ekleyin veya düşün, ücreti hesaba katın ve işlemi mutabakat için kaydedin.
Genel bakış
Her ödeme kontrollü aşamalardan geçer
Platform işleme kendi işlem numarasını verir, bunu ödeme sağlayıcısının yanıtıyla ilişkilendirir ve finansal durumu yalnızca onaylanmış sonuçtan sonra değiştirir. Yinelenen istek ikinci bir borçlandırma veya alacaklandırma oluşturmamalıdır.
Net durumlar
İşlem yalnızca izin verilen aşamalardan geçer ve tamamlanmış sonuç ayrı bir düzeltme olmadan değiştirilmez.
Ayrı finansal muhasebe
Ödeme durumu, bakiye değişikliği, ücret ve muhasebe kaydı birbirine bağlıdır ancak ayrı ayrı kontrol edilir.
Para yatırma akışı
Tipik para yatırma akışı
Para yatırma işlemi dahili bir operasyonla başlar ve ödeme sağlayıcısının onayından sonra tek seferlik bakiye artışıyla tamamlanır.
01
İsteği doğrulayın ve işlemi oluşturun
Platform oyuncuyu, KYC'yi, limitleri, para birimini, tutarı ve ödeme yöntemini kontrol eder, ardından dahili işlem numarası atar.
02
Ödemeyi sağlayıcıya gönderin
Sağlayıcı tutarı, para birimini, oyuncu verilerini, dönüş URL'sini, bildirim URL'sini ve gerekli ödeme bilgilerini alır.
03
Ödemeyi onaylayın
Oyuncu ödemeyi harici sayfada, 3-D Secure üzerinden veya bankacılık uygulamasında onaylar.
04
Onayı alın ve fonları bakiyeye ekleyin
İmza ve nihai durum doğrulandıktan sonra platform oyuncu bakiyesini bir kez artırır ve işlemi tamamlar.
Para çekme ve iade
Para çekme, iptal ve iadeler
Giden işlemler; oyuncunun, kullanılabilir bakiyenin, riskin, ödeme bilgilerinin ve ödeme sağlayıcısının nihai yanıtının doğrulanmasını gerektirir.
Oyuncu doğrulama
KYC, yaş, hesap durumu, limitler, kendini hariç tutma ve izin verilen para çekme yöntemleri.
Risk kontrolleri
AML, dolandırıcılık göstergeleri, çevrim koşulları, fon kaynağı ve operatör onayı.
Tutarı rezerve edin
Nihai ödeme sonucu alınana kadar tutar bakiyede bloke edilir.
Ödeme sağlayıcısına gönderin
Benzersiz numara ve doğrulanmış alıcı bilgileriyle ayrı bir ödeme talebi oluşturulur.
Sonucu bekleyin
Platform ara durumları kabul eder ve tutarı tekrar düşmez.
İade
İade, orijinal ödemeye ve kendi tutarına bağlı ayrı bir işlem olarak oluşturulur.
İptal
İptal yalnızca geri döndürülemez aşamadan önce mümkündür ve tamamlanmış işlem için iadenin yerini tutmaz.
Nihai mutabakat
Sağlayıcı raporu, ödeme verileri, ücretler ve bakiye değişiklikleri aynı sonucu göstermelidir.
İşlem durumları
Önerilen durum modeli
Dahili durumlar, farklı ödeme sağlayıcısı yanıtlarını platform için tek ve anlaşılır bir modele dönüştürür.
Oluşturuldu
İşlem platform içinde oluşturulmuştur ancak henüz sağlayıcıya gönderilmemiş veya sağlayıcı tarafından kabul edilmemiştir.
Eylem gerekli
Oyuncunun ödemeyi onaylaması, bilgi girmesi veya bankasında işlem yapması gerekir.
İşleniyor
Sağlayıcı işlemi kabul etmiştir ancak nihai sonuç henüz onaylanmamıştır.
Tamamlandı
İşlem başarıyla tamamlanmıştır; ardından bakiye yalnızca bir kez değiştirilir.
Reddedildi
İşlem reddedilerek sona ermiştir; neden saklanır ve ek borçlandırma veya alacaklandırma yapılmaz.
Onaylanmadı
Bağlantı hatası, yanıt gecikmesi veya çelişkili veriler nedeniyle işlemin sonucu bilinmemektedir.
Bilinmeyen sonuç red olarak değerlendirilemez
Zamanında yanıt alınmasa bile ödeme sağlayıcı tarafından kabul edilmiş olabilir. Önce güncel durumu sorgulayın veya onay bekleyin; ardından başka bir işlemin gerekli olup olmadığına karar verin.
Güvenilirlik ve mutabakat
Yinelenen işlemlere karşı koruma ve finansal mutabakat
Ödeme API'sinin güvenilirliği, yinelenen isteklerde, gecikmiş onaylarda ve kısmi arızalarda güvenli davranışa bağlıdır.
Yinelenen işlemlere karşı koruma
Her para yatırma, para çekme ve iade işlemi benzersiz bir numara alır.
Yinelenen istek mevcut sonucu döndürür ve yeni bir finansal işlem oluşturmaz.
Yinelenen bildirim olay numarası ve mevcut ödeme durumuna göre kontrol edilir.
Bakiye değişikliği ödeme numarasıyla ilişkilendirilir ve yalnızca bir kez uygulanır.
Finansal muhasebe ve mutabakat
Tutarı, ücreti, net tutarı, para birimini ve sağlayıcı referansını ayrı ayrı saklayın.
Tamamlanmış kaydı geriye dönük olarak değiştirmeyin; ayrı bir düzeltme oluşturun.
API işlemlerini, sağlayıcı raporlarını, bakiye değişikliklerini ve ödemeleri mutabık hale getirin.
Her farkı, nedenini, sorumlusunu ve çözüm sonucunu kaydedin.
Test
Lansmandan önce neler test edilmeli
Başarılı ödeme, red, bağlantı kaybı, yinelenen onay, bilinmeyen sonuç, iade ve finansal mutabakatı test edin.
Başarılı para yatırma ve para çekme
Tüm ara durumlar, onay, bakiye değişikliği ve nihai raporlama.
İşlem reddi
Yetersiz fon, geçersiz bilgiler, limit aşımı, banka reddi, risk incelemesi ve kullanılamayan ödeme yöntemi.
Bağlantı kaybı
İstek gönderildikten sonra bağlantı kesilir; onay daha sonra gelir veya ayrıca sorgulanır.
Yinelenen istekler
Aynı işlem veya onay, işleme tamamlandıktan sonra tekrar gelir.
İade ve iptal
Tam ve kısmi iade, işleme alınmadan önce iptal ve tamamlanmış işlemin iptal edilememesi.
Mutabakat
Tutar, ücret, nihai durum, bakiye ve sağlayıcı raporu tüm senaryolardan sonra eşleşir.
Lansman öncesi kontrol listesi
Canlı ödemeler; durumlar, onaylar, yinelenen işlemlere karşı koruma, bakiyeler ve finansal raporlama doğrulandıktan sonra etkinleştirilir.
Test ve canlı ortamlar farklı kimlik bilgileri, bildirim endpoint'leri ve hesaplar kullanır.
Kullanıcının web sitesine dönmesi başarılı ödemenin kanıtı olarak kullanılmaz.
Bakiye değiştirilmeden önce imza ve olay numarası doğrulanır.
Para yatırma, para çekme ve iadeler yinelenen çalıştırmaya karşı korunur.
Bilinmeyen durum sağlayıcıyla netleştirilir ve mutabakat sırasında kontrol edilir.
Hata uyarıları, PSP raporları ve fark inceleme süreci yapılandırılmıştır.
Ödeme akışı tasarlamanız mı gerekiyor?
PSP listenizi, ödeme yöntemlerinizi, para birimlerini, pazarları, bakiye kurallarını ve durumları bize iletin. APIACE para yatırma, para çekme, iadeler, onay ve finansal mutabakatı yapılandırmaya yardımcı olacaktır.