Documentation Index
Fetch the complete documentation index at: https://docs.payven.com.tr/llms.txt
Use this file to discover all available pages before exploring further.
Tüm Payven API’lerinde tutarlar kuruş cinsinden, tam sayı (integer) olarak iletilir. Ondalıklı (float, decimal) değer kabul edilmez.
Çevrim kuralı
tutar (kuruş) = tutar (₺) × 100
| Görünen tutar | API değeri |
|---|
| 0,01 ₺ | 1 |
| 1,00 ₺ | 100 |
| 25,50 ₺ | 2550 |
| 150,00 ₺ | 15000 |
| 1.234,56 ₺ | 123456 |
| 1.999.999,99 ₺ | 199999999 |
Örnek dönüştürme fonksiyonları
public static long LiraToKurus(decimal lira) => (long)Math.Round(lira * 100m);
public static decimal KurusToLira(long kurus) => kurus / 100m;
// Görüntüleme
public static string FormatKurus(long kurus) =>
(kurus / 100m).ToString("N2", new CultureInfo("tr-TR")) + " ₺";
Float kullanmayın. Ondalık aritmetiği yuvarlama hatalarına yol açar. Çevrimi mutlaka tamsayı (integer/long) ile yapın.
Para birimleri
| Kod | Para birimi | Durum |
|---|
TRY | Türk Lirası | ✅ Birincil |
USD | Amerikan Doları | ✅ DCC ile destekli |
EUR | Euro | ✅ DCC ile destekli |
GBP | İngiliz Sterlini | ✅ DCC ile destekli |
Sınır değerler
| Kural | Limit |
|---|
| Minimum işlem tutarı | 100 kuruş (1,00 ₺) |
| Maksimum tek işlem tutarı | Plan ve banka anlaşmanıza göre değişir |
| Kısmi iade tutarı | Orijinal işlem tutarını aşamaz |
VALIDATION_AMOUNT_TOO_LOW, VALIDATION_AMOUNT_EXCEEDED veya REFUND_EXCEEDS_ORIGINAL hatası döner.
