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ı
1
API kimlik bilgilerini alın
Fincraft panelinden veya entegrasyon ekibinden API Key ve API Secret değerlerinizi temin edin.
2
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.3
Ö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.4
İşlemi doğrulayın
Order ID veya Reference ID ile sorgulama endpoint’lerinden işlem durumunu kontrol edin; gerekirse iptal/iade işlemlerini uygulayın.
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ı.