Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.orkesta.com.tr/llms.txt

Use this file to discover all available pages before exploring further.

Fincraft Payment API, REST mimarisi üzerine kurulu olup JSON formatında yanıt döner. Kart ödemesi, 3D Secure, ortak ödeme/link/QR, taksit sorgulama, iptal/iade ve bayi yönetimi gibi tüm ödeme işlemlerini kendi uygulamanızdan veya scriptlerinizden yönetebilirsiniz.
🌐 Ortamapi-test.fincraft.com.tr
📋 Endpoint24 API
🔐 Kimlik DoğrulamaBearer Token
📝 Content-Typeapplication/json
🔡 EncodingUTF-8

​
Base URL

OrtamBase URL
Testhttps://api-test.fincraft.com.tr/api/v1
Test ortamı gerçek para hareketi gerçekleştirmez. Canlı ortama geçmeden önce tüm entegrasyonunuzu test URL’i üzerinden doğrulayın.

​
Kimlik Doğrulama

API’ye erişim için önce Bearer Token almanız gerekir.

​
Token Alma — POST /auth/login

POST https://api-test.fincraft.com.tr/auth/login
API Key ve API Secret değerlerinizi apiKey:apiSecret biçiminde birleştirip Base64 ile encode edin, ardından Authorization: Basic başlığında gönderin. 
# 1. Encode
echo -n "apiKeyBilginiz:apiSecretBilginiz" | base64
# ZmluY3JhZnRUZXN0S2V5OmZ...

# 2. Token al
curl -X POST https://api-test.fincraft.com.tr/auth/login \
  -H "Authorization: Basic ZmluY3JhZnRUZXN0S2V5OmZ..." \
  -H "Content-Type: application/json"
Response: 
{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
Dönen accessToken değerini sonraki tüm isteklerde Authorization: Bearer başlığında kullanın.

​
İstek Başlıkları

Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

​
Desteklenen Para Birimleri

KodAçıklamaISO
TRYTürk Lirası949
USDAmerikan Doları840
EUREuro978
GBPİngiliz Sterlini826

​
Ödeme Durumları (PaymentStatus)

DurumAçıklama
SUCCESSBaşarılı
FAILUREBaşarısız
WAITINGBeklemede
INIT_THREEDS3D Secure başlatıldı
CALLBACK_THREEDS3D Secure callback
CANCELLEDİptal edildi
COMPLETEDTamamlandı
PARTIALLY_REFUNDEDKısmen iade edildi

​
İşlem Tipleri (TransactionType)

TipAçıklama
AUTHYetkilendirme (varsayılan)
PREAUTHÖn provizyon
POSTAUTHProvizyon kapama
VOIDİptal
REFUNDİade

​
Hata Formatı

{
  "code": 6001,
  "message": "Geçersiz istek"
}
HTTP KoduAnlamı
200Başarılı
400Geçersiz istek / validasyon hatası
401Kimlik doğrulama başarısız
403Erişim reddedildi
404Kayıt bulunamadı
500Sunucu hatası

Kimlik Doğrulama

Bearer Token alma adımları ve Base64 encode işlemi.

Hata Kodları

Tüm sistem ve banka hata kodları.

Enumlar

API’de kullanılan enum değerleri.

Test Kartları

Test ortamı kart numaraları.