Skip to main content
Tüm Payven API’lerinde tutarlar kuruş cinsinden, 64-bit tam sayı (long) olarak iletilir. Ondalıklı (float, decimal) değer kabul edilmez. İstemci tarafında 32-bit int kullanmayın — yüksek tutarlı işlemlerde taşma riskine girersiniz. Tutar her zaman bir para birimiyle birlikte taşınır:

Çevrim kuralı

tutar (kuruş) = tutar (₺) × 100

Örnek dönüştürme fonksiyonları

Float kullanmayın. Ondalık aritmetiği yuvarlama hatalarına yol açar. Çevrimi mutlaka tamsayı (integer/long) ile yapın.

Para birimleri

Request body’sinde currency alanına şu an yalnız "TRY" gönderilir. Yabancı kartlarda DCC (Dynamic Currency Conversion) akışı devreye girerse Payven, kart para birimindeki çevrilmiş tutarı response body’sinde döner — istemci USD/EUR/GBP değerini doğrudan göndermez. Detay: DCC Akışı.

Sınır değerler

İhlal durumunda invalid_amount veya refund_exceeds_original kodu ile 422 Unprocessable Entity döner. Tüm hata yanıtları RFC 9457 problem+json formatındadır — bkz. Hata Yönetimi.