Genel Kurallar

Base URL & Metot

Tüm veri-düzlemi çağrıları https://<host>/partner/1.0/... altındadır ve POST + JSON gövde kullanır. Kimlik doğrulama için bkz. Kimlik Doğrulama.

Para Alanları

amount, cartAmount, partialAmount vb. tutar alanları decimal olarak gönderilir; minor unit (kuruş) kullanılmaz.

{ "amount": 1234.56, "currency": "TRY" }

Currency

Kaptan desteklenen ISO-4217 kodlarını kabul eder (mevcut entegrasyon kapsamında): TRY, USD, EUR, GBP, RUB, CHF, SAR, BHD, AZN, CAD, CNY, AUD, JPY, AED, KZT, IRR. Aktif currency listesi merchant başına yapılandırılır. Kart ödemesinde currency 3 harfli kod olarak gönderilir.

Tarih Formatı

ISO-8601. Örnek: 2026-07-12T10:15:30.000Z.

Pagination

page (0-tabanlı), size (aralık dışı değerlerde varsayılana döner, max 100).

referenceCode

Kart ödemesi gibi uçlarda referenceCode, merchant tarafındaki benzersiz sipariş/işlem referansıdır ve duplicate tespiti ile raporlama için kullanılır.

İşletme Kapsamı

İşlemler, API anahtarınızın tanımlı olduğu işletme kapsamında gerçekleşir. İstek gövdesinde ayrıca bir işletme bilgisi göndermenize gerek yoktur; kapsam API anahtarınızdan belirlenir.