Partner Programı

API herkese açıktır. Mükellef kendi panelinden anahtar üretip ürününüze verdiği anda entegrasyonunuz çalışır — bizimle anlaşma yapmanız gerekmez.

Partner programı, entegrasyonunuzu Finans Fatura kullanıcılarının önüne çıkarmak içindir.

Ne kazanırsınız

Mağazada listelenirsiniz. Ürününüz, mükelleflerin entegrasyon aradığı Uygulama Mağazası sayfasında kendi markanız, logonuz ve açıklamanızla yer alır. Mükellef "Kur" dediğinde doğrudan sizin kurulum akışınıza yönlendirilir.

Satışlarda markanız görünür. Sizin üzerinizden gelen her satış, mükellefin satış listesinde sizin logonuzla işaretlenir. Mükellef, hangi kanaldan ne sattığını görürken markanızı görür.

Kayıtlı olmayan bir kaynak FINANSFATURA olarak görünür — entegrasyon yine çalışır, sadece markanız görünmez.

OAuth istemcisi alırsınız. Kopyala-yapıştır anahtar adımı ortadan kalkar; mükellef ürününüzde "Finans Fatura'ya bağlan" der, onay ekranından geçer, bağlantı kurulur. Çok mükellefli ürünler için tek pratik yöntem budur.

Nasıl başvurulur

[email protected] adresine şunları gönderin:

1. Ürün adı ve kısa açıklama — mağazada görünecek metin
2. Logo — SVG tercih edilir, kare veya yatay
3. Kurulum yönlendirmesi — mükellef "Kur" dediğinde nereye gitmeli? Uygulama mağazanızdaki sayfanız, kendi kurulum sayfanız veya API anahtarı talimatınız
4. OAuth istiyorsanız — redirect_uri adresleriniz ve ihtiyaç duyduğunuz scope'lar
5. Teknik iletişim — entegrasyon sorunlarında ulaşacağımız kişi

Dönüş yaptığımızda sandbox'ta test edip, hazır olduğunuzda üretime alırız.

Entegrasyon beklentilerimiz

Listelenmeden önce şunları karşılamanızı bekliyoruz:

• Satış oluşturma kullanılıyor — zaten zorunlu; doğrudan fatura kesilemez
• Alıcı bilgisi kanalınızdan gerçekten taşınıyor — en az buyer.title, elinizde varsa tckn / tax_number ve email. Belgenin alıcısı bu alandan kuruluyor; e-posta ise e-Arşiv'in gönderim şeklini (ELEKTRONIK / KAGIT) belirliyor
• external_id her sipariş için tekil ve kararlı
• Idempotency-Key fatura isteklerinde gönderiliyor
• Tekrar deneme artan aralıklarla, 4xx hatalarında ısrarsız
• Hata mesajları son kullanıcıya anlaşılır biçimde gösteriliyor — özellikle 412 (mükellefin kurulumu eksik) durumu

Bunlar bizim keyfi kurallarımız değil; sahada en çok destek talebi yaratan noktalar.

Sunucu-sunucu kimlik

Kayıtlı partnerlere appName + developerKey + saltKey üçlüsü verilir; sunucunuz isteklerini bununla imzalar. Kural, örnekler ve mükellef başvurusu ucu: Partner İmzası.

Sorular

Teknik: [email protected] Genel: finansfatura.com