Kendi sistemlerinizi TransferGo'ya bağlayın ve işlem geçmişinizi otomatik olarak alın; kontrol etmek için giriş yapmanıza gerek kalmaz.
TransferGo İşletme API'si nedir ve bununla ne yapabilirim?
TransferGo ile bağlantı kurmanın yeni bir yolunu ekliyoruz: TransferGo İşletme API'si. Bu, işletmenizin işlem geçmişini doğrudan kendi sistemlerinizden alabilmenizi sağlar; ödemelerinizi kontrol etmek istediğiniz her seferde portala giriş yapmanıza gerek kalmaz.
Özellikle şu durumlarda faydalıdır:
- Ödemelerin mutabakatını düzenli olarak yapıyorsanız: işlem verilerinizi doğrudan kendi muhasebe veya ERP (Kurumsal Kaynak Planlama) yazılımınıza çekin.
- Bir geliştirici ekibiniz varsa: bir kez bağlanın ve kontrol işlemini sistemlerinizin sizin yerinize yapmasına izin verin.
Şu anda bu, yalnızca hesap hareketlerinizin görüntülenmesini kapsamaktadır. API aracılığıyla ödeme gönderme özelliği bu yılın sonlarına doğru gelecek; hazır olduğunda size haber vereceğiz.
API’nin neler yapabileceğine dair tam bir fikir edinmek için geliştirici belgelerine bakın.
Sistemlerimi TransferGo İşletme API'si bağlamaya nasıl başlayabilirim?
- API Entegrasyonlarını Açın: TransferGo İşletme hesabınıza giriş yapın ve sol taraftaki menüden API Entegrasyonları'na tıklayın.
- Bağlantıyı başlatın: Kabul et ve API bağlantısı oluştur'a tıklayın.
- Şartları kabul edin: Bir API bağlantısı oluşturmak, güncellenmiş Şartlar ve Koşullarımızı kabul etmeyi gerektirir.
Hesap Sahibi değil misiniz? Bu adımı kendiniz onaylayamazsınız; ne yapmanız gerektiğini öğrenmek için sonraki makaleye bakın.
Hesap Sahibi olarak bir API bağlantısını onaylama
Bir ekip üyesi API bağlantısı kurmaya başlar ancak kendisi hesap sahibi değilse, bağlantının aktifleşmesi için sizin onayınıza ihtiyaç duyacaktır.
- Onay linkini alın: Ekip üyeniz, bağlantıyı onaylamanız için size bir link gönderecektir.
- İnceleyin ve kabul edin: Linki açın ve güncellenmiş Şartlar ve Koşulları kabul edin.
- Bitti: Onaylandıktan sonra ekip üyeniz sertifika kurulumuna ve sistemlerini bağlamaya devam edebilir.
API sertifikamı nasıl oluşturur ve bağlanırım?
Bağlantınız onaylandıktan sonra, sistemlerinizin güvenli bir şekilde bağlanmasını sağlayan bir istemci sertifikası oluşturacak ve ardından bunu kullanarak bir erişim jetonu alacaksınız.
Bilmeniz gereken temel noktalar:
- Özel anahtarınız kendi makinenizde oluşturulur ve bu makineden asla dışarı çıkmaz.
- Sertifikalar 1 yıl süreyle geçerlidir.
- Erişim jetonlarının geçerlilik süresi 5 dakikadır; bu nedenle her çağrı için yeni bir jeton talep etmek yerine, jetonları önbelleğe alıp yeniden kullanın.
- Sertifika imzalama isteğinizi (CSR) yüklemek hassas bir adımdır; bu nedenle, şifrenizle onaylamanız istenecektir.
Nasıl yapılır:
- API Entegrasyonları'nı açın ve işletim sisteminize (Windows veya macOS/Linux) uygun Nasıl bağlanılır kılavuzunu izleyin.
- Gösterilen adımları izleyerek sertifikanızı oluşturun, ardından bir erişim jetonu alın ve bağlantınızı test edin.
İşlemin ortasında takıldınız mı? Kurulum ekranında Yardıma ihtiyacım var bağlantısı bulunmaktadır.
Kesin komutlar, sertifika ayrıntıları ve jeton istekleri için Kimlik Doğrulama ve Yetkilendirme kılavuzuna bakın.
API sertifikalarımı nasıl yönetebilirim?
Sertifikalarınızı istediğiniz zaman API Entegrasyonları bölümünden yönetebilirsiniz.
A. Sertifikanızı indirme
- API Entegrasyonları'na gidin.
- Tablodan sertifikanızı bulun ve .CRT'yi İndir'e tıklayın.
B. İkincil bir sertifika ekleme
- API Entegrasyonları'na gidin.
- İkincil sertifika ekle'ye tıklayın.
Bu, birincil sertifikanızın süresi dolmadan önce hazırda bir yedek sertifika bulundurmak istiyorsanız faydalıdır.
C. Bir sertifikayı iptal etme
- API Entegrasyonları'na gidin.
- Kaldırmak istediğiniz sertifikayı bulun ve yanındaki iptal simgesine tıklayın.
- Kaldırma işlemini onaylayın.
İptal edildikten sonra, bu sertifika artık bağlanmak için kullanılamaz; iptal etmeden önce sistemlerinizin ona bağlı olmadığından emin olun.
Bilmeniz gereken en önemli nokta: Sertifikaların geçerlilik süresi 1 yıldır. Kesintiye uğramadan sertifika rotasyonu gerçekleştirmek için, birincil sertifikanızın geçerlilik süresi dolmadan önce ikincil bir sertifika ekleyin, sistemlerinizi bu sertifikaya geçirin ve ardından birincil sertifikayı iptal edin.
Sertifika geçerlilik süresi ve rotasyonu hakkında daha fazla bilgi için bkz. Sertifika geçerlilik süresi ve rotasyonu.
TransferGo Business API aracılığıyla hangi bilgileri alabilirim?
Bağlantı kurulduktan sonra, hesap hareketlerinizi doğrudan kendi sistemlerinize aktarabilirsiniz. Bu, havale ve para yüklemelerinin yanı sıra döviz işlemleri, tasarruf mevduatları ve para çekme işlemleri, faiz ve bakiye düzeltmelerini de kapsar.
Her işlem için durum, tarih ve saat, tutarlar ve para birimleri, ücretler, referans numaralarınız ile gönderen ve alıcı bilgileri gibi ayrıntıları alacaksınız; güvenlik amacıyla kart numaraları gizlenmiş olacaktır.
Sonuçlar sayfalandırılmış ve filtrelenebilir olduğundan, büyük işlem geçmişleri yönetilebilir parçalar halinde yüklenir.
Bu özellik şimdilik salt okunur durumdadır: verileri alabilirsiniz, ancak API üzerinden henüz ödeme gönderemezsiniz. Bu özelliğin bu yılın ilerleyen aylarında kullanıma sunulması planlanmaktadır.
Alanların, durumların ve filtreleme seçeneklerinin tam listesi için işlem referansına bakın.