Mimari Genel Bakış

Payven, ortak bir kimlik servisi etrafında düzenlenmiş bağımsız ürün servislerinden oluşur. Tek bir access token ile planınızdaki tüm ürünleri çağırırsınız.

​

Servis topolojisi

İlk adımda Identity’den client_credentials akışıyla bir access token alırsınız; sonraki tüm istekleri ürün servislerine Authorization: Bearer <access_token> header’ı ile yaparsınız. Aynı token Sanal POS ve Para Transferi servislerinin ikisinde de geçerlidir. Tüm ürün servisleri aynı Bearer access token’ı kabul eder; servis başına ayrı kimlik akışı yoktur. Fraud servisinin endpoint’leri (kural CRUD, manuel inceleme) Sanal POS API’siyle birlikte sunulur.

​

Organizasyon ve merchant modeli

Payven üç katmanlı bir hesap yapısı kullanır:

• Organizasyon (Tenant): Payven’i kullanan firma. Tipik olarak ödeme kuruluşu, banka veya büyük platform olur — lisans zorunluluğu yoktur. Tüm API anahtarları ve banka konfigürasyonları bu seviyede yönetilir.
• Merchant: Organizasyona bağlı bayi veya alt müşteri. Her ödeme bir merchant adına gerçekleştirilir.
• Alt Merchant: İsteğe bağlı olarak merchant ağacında ek seviye (örneğin marketplace satıcıları).

Detay: Hesap Yapısı.

​

İstek yaşam döngüsü

Aşağıda kart ödeme isteğinin Sanal POS servisinden geçişi gösterilmiştir; Para Transferi ve Fraud için de mantık aynıdır.

​

Ortam URL’leri

Her servis kendi alt-domain’i üzerinden hizmet verir. Tüm path’ler /api/v1 ile başlar. Fraud kontrolü Sanal POS akışlarının içinde otomatik çalışır — sizin tarafınızdan ayrı bir API çağrısı gerekmez. Kural yönetimi konsoldan yapılır. Sandbox ortamı, organizasyonunuzun konnektör konfigürasyonuna göre ya simülasyonla yanıt üretir ya da bankanın test ortamına gerçek çağrı atar — bkz. Sandbox Ortamı. Production geçişi öncesinde Go-live kontrol listesini tamamlayın.