1
Hesabı ve hareketi okuyun
Bağlı hesapları, ardından hareketleri okuyun. Gerekirse hareket ayrıntısını alın.Hesabı yenileme GET çağrısı banka hizmetini çalıştırır ve yerel verileri değiştirebilir; write izni ister. Hesap meşgulse
409, hizmet sorunu varsa 502 alınabilir.2
Eşleşme adayını değerlendirin
Eşleşme tahmini eşleştirme adaylarını gösterir; hareketi onaylamaz ve ödeme oluşturmaz. Cariyi, banka yönünü, para birimini, tutarı ve varsa faturayı kendi iş bağlamınızda doğrulayın.
3
Onay türünü seçin
Onay ucunda
type=contact cariye ödeme, type=invoice faturaya mahsup içindir. Her durumda hedef ve contactsId ilişkisi aynı firmada doğrulanmalıdır. Fatura mahsubunda contactsId zorunludur.Banka yönü tahsilat/ödeme yönüyle uyuşmalıdır. IBAN yalnız doğrulanan cariye ilişkilendirilir; başka cariye ait bir bilgiyi değiştirmek için bu ucu kullanmayın.4
Mali sonucu doğrulayın
Dönen işlem makbuzunu ve güvenli ödeme/kayıt kimliklerini saklayın. Hareket ve ilgili fatura/ödeme durumunu tekrar okuyarak sonucu doğrulayın. Aynı hareketi yeni anahtarla tekrar onaylamayın.
Faturaya mahsupta desteklenen sınır
- Fatura açık ve daha önce hiç ödeme almamış olmalıdır.
- Hareket, aynı firma/cari/para birimindeki faturanın tam tutarını karşılamalıdır.
- Gereken döviz kuru kaydedilmiş ve pozitif olmalıdır. TRY dışındaki kanıtsız
1kuru veya faturayla uyuşmayan kur desteklenmez. - Kısmi, daha önce ödenmiş, kapalı veya kur farkı gerektiren durumlar
422ile reddedilir; ödeme kaydı oluşturulmaz.
Otomasyon kullanıyorsanız
Banka otomasyonları API’de yalnız TRY hesabı ve desteklenen tek fatura aksiyonu sınırında çalışır. Aktif tanımın ayar ve satır dağılımı koşullarını sağlayın. Manuelrun GET çağrısı mali işlem yapar ve Idempotency-Key ister.
Bir satırın sonucu belirsizse bütün çalışmayı başarılı saymayın. review_required durumunda otomasyon geçmişini, ilgili faturaları ve işlem sonucunu inceleyin; yeni anahtarla tekrar çalıştırmayın.