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