Adım Adım Issuing API - Payantis Platform

Payantis Issuing API'lerinin kullanımına hızlı bir başlangıç yapmak için aşağıdaki adımlar uygulanır.

Bağlantılar ve Temel Kurum Tanımları

Payantis API’lerini kullanmaya başlamadan önce, güvenli bir bağlantı kurmak ve temel kurum yapılandırmalarını tamamlamak gerekmektedir. Bu adımda, ağ bağlantısı kurulumu, kimlik doğrulama mekanizmaları ve temel API erişimi için gereken işlemleri gerçekleştirilir.

Kurum Tanımları: Kurumun temel bilgileri, üye olduğu şemalar, şemalardan aldığı BIN'ler, temel operasyonel parametreler Payantis Operasyon ekibi tarafından Platform'da tanımlanır.

IPSec Tünel Kurulumu : Payantis API’lerine erişim için Kurum sistemleri ile Payantis altyapısı arasında IPSec tüneli kurulur, bunun için ağ yöneticileri karşılıklı tanımları yaparlar.

API Kimlik ve Yetki Tanımları: Payantis API’leri JWT (JSON Web Token) tabanlı bir kimlik doğrulama sistemi kullanır. Bunun için gerekli olan kullanıcı bilgileri Payantis Operasyon ekibi tarafından oluşturulur ve Kurum ile paylaşılır.

Güvenlik Anahtarları: Kurum ile Payantis arasında PIN, CVV gibi hassas verilerin güvenli şekilde taşınmasını için, Payantis ve Kurum uygun şifreleme anahtarlarını oluştururlar ve karşılıklı olarak paylaşırlar. Kurum, anahtarları güvenli şekilde saklar ve veri alma verme işlemlerinde kullanır.

Ürün Tanımları

Kart ürünü, kartların özelliklerini ve kurallarını belirleyen temel bir yapılandırmadır. Ürün tanımı Platform API'leri ya da Payantis UI üzerinden yapılır, Kurumun kendisi ürünü tanımlayabileceği gibi Payantis Operasyon ekibi de kurum adına tanımlayabilir. Başlıca ürün özellikleri:

Kart Şeması: VISA, Mastercard veya TROY gibi hangi kart ağında çalışacağı, BIN ve BIN aralığı.

Kart Türü: Fiziksel, Sanal, Ön ödemeli, banka kartı, kredi kartı.

Harcamaya Yönelik Limitler (Velocity Checks): Günlük, aylık veya tek seferlik işlem limitleri.

Kullanım Kısıtlamaları (Authorization Controls): ATM, POS, online alışveriş gibi hangi kanallarda kullanılabileceği.

Ücretler: Kartlardan alınabilecek işlem ücreti, yıllık aidatlar, fiziksel kart basım ücretleri.

Diğer Özellikler: Kart görseli, vade süresi, vb.

Ürün tanımı yapılırken bir ürün kodu (productCode) belirtilir ve sonraki adımlarda bu kod kullanılır.

Müşteri ve Kart Tanımı

Payantis Platform'da isimsiz kartlar dışındaki tüm kartların bir sahibi olması gerektiğinden önce müşteri kaydı oluşturulur. Ardından bu müşteriye çeşitli kartlar (fiziksel, sanal) üretilir. Üretilen kartların token Id'lerinin Kurum'un sistemine kaydedilmesi tavsiye edilir. Kartlar ile sorgulama, bilgi alma, aktivasyon, kapatma, güvenlik (pin, cvv) işlemleri gibi fonksiyonlar denenebilir.

İşlem (Transaction) Simülasyonları ve Testleri

Kartlar başarıyla oluşturulup aktif hale geldikten sonra, bu kartlarla yapılabilecek işlemleri test etmek ve simüle etmek önemlidir.

İşlem Simülasyonları: Gerçek işlemler öncesinde sistemin doğru çalıştığını teyit etmek için işlemler simüle edilir ve bu sayede Platforum'un her türlü senaryo için nasıl tepki vereceği anlaşılır.

İşlem İptali ve İadesi: Yapılan işlemler iptal ve iade edilir, bu sayede yanlış yapılan ödemelerin iptal sonrası kartın durumu ve bakiyesini eski haline geldiği görülür.

Kontroller: Çok çeşitli türdeki işlemlerin (para çekme, alışveriş, e-ticaret, şifreli, şifresiz, vb.) yetki, harcama kontrolü, bakiye gibi kontrollerinin sorunsuz olduğu test edilir.

İşlem Sorgulama ve Listeleme: Bir işlem gerçekleştikten sonra, işlem durumu sorgulanabilir ve işlemler toplu olarak listelenebilir. Bu şekilde işlem onayı, reddi, otorizasyon durumunu kontrol edilir.

Performans Testi ve Yük Testi: İşlem simülasyonları ile işlem süreleri ölçülebilir ve varsa performans sorunları anlaşılır. Ayrıca, bir miktar yük verilerek sistemin davranışı görülebilir.

Webhook Bildirimleri

Webhook bildirimleri, Payantis API ile entegrasyon sırasında önemli bir role sahiptir. Bu bildirimler, işlemlerin, kart durumlarının ve diğer olayların gerçek zamanlı olarak Kuruma iletilmesini sağlar.

Webhook Yapılandırması: Kurum almak istediği olay bildirimleri için Payantis API'ler üzerinden kayıt olur. Kayıt sırasında olaylar, bildirim url'leri, yetkilendirme ve diğer bildirim parametreleri verilir.

Bildirimlerin Alınması ve İşlenmesi: Bildirim alınması olaylar oluşturulması gerekir, bunun için kart, müşteri ve işlem simülasyon API'leri kullanılabilir. Olaylar oluştuktan sonra Payantis Platform bunları Kuruma bildirir ve işlendiğinden emin olur. Bu noktada olası hatalar ve sorunlar Payantis ve Kurum tarafından karşılıklı olarak değerlendirilir ve çözüme