Temel Bilgiler

Bu doküman, Finrota Ödeme Web Serivisi (PWS) REST API servislerini sisteminize entegre ederek tüm ödeme süreçlerinizi uçtan uca yönetmenize yardımcı olmak amacıyla hazırlanmıştır.

Amaç; ödeme setlerini, POS oranlarını, ödeme başlatma–tamamlama adımlarını ve iptal/iade işlemlerini tek bir bütünsel API yapısı üzerinden güvenli şekilde yürütmektir.

Ne İçin Var?

Finrota ödeme altyapısı, üye işyerlerinin veya bayilerin ödeme işlemlerini yönetebilmesi için tasarlanmıştır.

Aşağıdaki ana işlevleri destekler

• Tanımlı ödeme setlerini, POS’ları ve oranlarını listeleme
• Yeni bir ödeme isteği başlatma ve tamamlama
• Tamamlanan işlemlerin detaylarını görüntüleme
• ERP sistemleriyle entegre GetPayment mantığına uygun detay dönüşü
• Referans veya üye işyeri referansı üzerinden iptal (cancel) ve iade (refund) işlemleri gerçekleştirme

Nasıl Bağlanıyor?

• Tüm servisler HTTPS/REST protokolü üzerinden çalışır.
• Veri alışverişi JSON formatında, UTF-8 karakter setiyle yapılır.
• Tüm çağrılar TLS 1.2+ ile şifrelenmiş olmalıdır.

Güvenlik

• Bearer Token tabanlı yetkilendirme (AccessToken) zorunludur.
• Token alma ve yenileme süreci için bkz: 2. Kimlik Doğrulama – AccessToken Alınması.
• Her istek, geçerli bir AccessToken içermelidir; süresi dolan tokenlar 401 hatası döndürür.

Ortamlar

Ortam	URL	Açıklama
Demo Ortamı (Sandbox)	https://pgw.netahsilatdemo.com	Test ve geliştirme ortamı; gerçek finansal işlem yapılmaz.
Canlı Ortam (Production)	https://api.finrota.com	Gerçek ödeme işlemlerinin yürütüldüğü ortam.