> ## 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.

# Anasayfa

Fincraft Payment API; kart ile ödeme, 3D Secure, ortak ödeme (checkout/link/QR), alternatif ödeme yöntemleri (APM), iptal/iade, provizyon ve işlem sorgulama işlemlerini REST üzerinden yönetmenizi sağlar. Tüm istekler JSON formatında gönderilir ve yanıtlar UTF-8 kodlamasıyla döner.

|                      |                                    |
| -------------------- | ---------------------------------- |
| **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`                 |

<Note>
  Test ortamı gerçek para hareketi gerçekleştirmez. Canlı ortama geçmeden önce entegrasyonunuzu `api-test.fincraft.com.tr` üzerinden doğrulayın.
</Note>

## Başlangıç

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/fincraft/genel/genel-bilgiler">
    Base URL, kimlik doğrulama ve ilk API çağrınız için adım adım rehber.
  </Card>

  <Card title="Kimlik Doğrulama" icon="key" href="/fincraft/genel/genel-bilgiler">
    API Key ve Secret ile Bearer Token alma, header kullanımı ve hata senaryoları.
  </Card>

  <Card title="API Referans" icon="code" href="/api-reference/introduction">
    Ortam bilgileri, para birimleri, ödeme durumları ve hata formatı özeti.
  </Card>

  <Card title="Postman Koleksiyonu" icon="download" href="/fincraft/genel/postman">
    Tüm endpoint'leri içeren Postman koleksiyonu ve ortam değişkenleri.
  </Card>
</CardGroup>

## Ödeme akışları

Entegrasyonunuzda kullanacağınız ödeme modeline göre ilgili bölüme geçin.

<CardGroup cols={2}>
  <Card title="Non-Secure Ödeme" icon="credit-card" href="/fincraft/non-secure/odeme-olustur">
    Kart bilgisi ile doğrudan ödeme oluşturma (`POST /api/v1/payments`).
  </Card>

  <Card title="3D Secure" icon="shield-check" href="/fincraft/3d-secure/3d-odeme-baslat">
    3D Secure başlatma ve doğrulama sonrası ödeme tamamlama akışı.
  </Card>

  <Card title="Ortak Ödeme / Link / QR" icon="link" href="/fincraft/ortak-odeme/islem-olustur">
    Checkout oturumu, token ile ödeme alma ve 3D checkout tamamlama.
  </Card>

  <Card title="APM Ödemeleri" icon="wallet" href="/fincraft/apm/multinet">
    Multinet, Pluxee, Edenred ve diğer alternatif ödeme yöntemleri.
  </Card>
</CardGroup>

## Entegrasyon adımları

<Steps>
  <Step title="API kimlik bilgilerini alın">
    Fincraft panelinden veya entegrasyon ekibinden **API Key** ve **API Secret** değerlerinizi temin edin.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Ö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.
  </Step>

  <Step title="İş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.
  </Step>
</Steps>

## Referans ve test araçları

<CardGroup cols={2}>
  <Card title="Enumlar" icon="list" href="/fincraft/genel/enumlar">
    `PaymentStatus`, `TransactionType`, `Currency` ve diğer enum değerleri.
  </Card>

  <Card title="Hata Kodları" icon="circle-alert" href="/fincraft/genel/hata-kodlari">
    Sistem ve banka kaynaklı tüm hata kodları ve açıklamaları.
  </Card>

  <Card title="Test Kartları" icon="flask-conical" href="/fincraft/genel/test-kartlari">
    Sandbox ortamında kullanılabilecek test kart numaraları.
  </Card>

  <Card title="3D Hash Doğrulama" icon="fingerprint" href="/fincraft/genel/3d-hashleme">
    3D Secure callback ve işlemlerde SHA-256 hash doğrulama algoritması.
  </Card>
</CardGroup>

## 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                         |

<Tip>
  Tüm endpoint'ler için hazır istek örnekleri [Postman koleksiyonunda](/fincraft/genel/postman) bulunur.
</Tip>

## Destek

Entegrasyon sırasında teknik destek için [Orkesta](https://orkesta.com.tr) üzerinden bizimle iletişime geçebilirsiniz.