| Test Base URL | https://api-test.fincraft.com.tr |
| API sürümü | v1 (/api/v1/...) |
| Kimlik doğrulama | Bearer Token (POST /auth/login) |
| Content-Type | application/json |
Test ortamı gerçek para hareketi gerçekleştirmez. Canlı ortama geçmeden önce entegrasyonunuzu
api-test.fincraft.com.tr üzerinden doğrulayın.Başlangıç
Quick Start
Base URL, kimlik doğrulama ve ilk API çağrınız için adım adım rehber.
Kimlik Doğrulama
API Key ve Secret ile Bearer Token alma, header kullanımı ve hata senaryoları.
API Referans
Ortam bilgileri, para birimleri, ödeme durumları ve hata formatı özeti.
Postman Koleksiyonu
Tüm endpoint’leri içeren Postman koleksiyonu ve ortam değişkenleri.
Ödeme akışları
Entegrasyonunuzda kullanacağınız ödeme modeline göre ilgili bölüme geçin.Non-Secure Ödeme
Kart bilgisi ile doğrudan ödeme oluşturma (
POST /api/v1/payments).3D Secure
3D Secure başlatma ve doğrulama sonrası ödeme tamamlama akışı.
Ortak Ödeme / Link / QR
Checkout oturumu, token ile ödeme alma ve 3D checkout tamamlama.
APM Ödemeleri
Multinet, Pluxee, Edenred ve diğer alternatif ödeme yöntemleri.
Entegrasyon adımları
API kimlik bilgilerini alın
Fincraft panelinden veya entegrasyon ekibinden API Key ve API Secret değerlerinizi temin edin.
Bearer Token alın
POST https://api-test.fincraft.com.tr/auth/login endpoint’ine Authorization: Basic başlığı ile istek atın. apiKey:apiSecret değerini Base64 encode ederek gönderin.Ödeme endpoint'ini çağırın
Dönen
accessToken ile Authorization: Bearer başlığını kullanarak seçtiğiniz ödeme akışına (non-secure, 3D veya checkout) istek gönderin.Referans ve test araçları
Enumlar
PaymentStatus, TransactionType, Currency ve diğer enum değerleri.Hata Kodları
Sistem ve banka kaynaklı tüm hata kodları ve açıklamaları.
Test Kartları
Sandbox ortamında kullanılabilecek test kart numaraları.
3D Hash Doğrulama
3D Secure callback ve işlemlerde SHA-256 hash doğrulama algoritması.
API modülleri
Dokümantasyondaki endpoint’ler aşağıdaki modüllere ayrılmıştır. Her modül, ilgili HTTP metotları, request/response örnekleri ve hata senaryolarını içerir.| Modül | Kapsam |
|---|---|
| Genel | Kimlik doğrulama özeti, enumlar, hata kodları, test kartları, 3D hash ve Postman |
| Non-Secure Ödeme | Kart ile doğrudan ödeme oluşturma |
| 3D Secure | 3D başlatma ve tamamlama |
| Ortak Ödeme / Link / QR | Checkout oturumu, ödeme alma, BIN/taksit sorgulama |
| Sorgulamalar | Order/Reference ID, taksit, BIN, işlem arama, raporlar, puan sorgulama |
| İptal / İade | Tam ve kalem bazlı iade/iptal |
| Provizyon | Post-auth (provizyon kapama) |
| Ürün İşlemleri | Pazaryeri ürün onay, geri alma ve güncelleme |
| Bayi İşlemleri | Bayi CRUD ve komisyon yönetimi |
| APM | Multinet, Pluxee, Metropol, Edenred, Token Flex, Setcard |