Paynoloji Geliştirici Merkezi

Service URL & Post Type

Bu adımdan sadece kart için izin verilen taksit sayısını ve taksit oranlarını görüntüleyebilirsiniz. Taksitli satış yapmayacaksanız bir sonraki adıma geçebilirsiniz.

Servis Adresi: https://api.paynoloji.com/installments

Doğrulama Türü: Bearer Token

İstek Türü: POST / JSON

Değer Tür Zorunlu Açıklama
card_number string Evet Banka/Kredi kartı numarası
amount string / integer Evet Çekim yapılacak tutar (Numerik olmalı 2,1 kabul edilmez 2.1 kabul edilir.)
Header string Evet Header olarak Authorization: Bearer (Token) yollamanız gerekli

Örnek PHP Kodu


// TOKEN bilgilerini tanımla
define("Token", "Your Token");

// Kredi ve kart bilgilerini al
$credit_amount = $_POST['amount'];
$card_number = $_POST['number'];

// API isteği için veri dizisini oluştur
$pyz_data = [
    'card_number' => $card_number,
    'amount' => $credit_amount
];

// cURL öğesini başlat
$ch = curl_init("https://api.paynoloji.com/installments");

// cURL ayarlarını tanımla
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_TIMEOUT => 5,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json',
    'Authorization: Bearer Token'
    ],
    CURLOPT_POSTFIELDS => json_encode($pyz_data)
]);

// cURL isteğini gerçekleştir
$hRet = curl_exec($ch);

// cURL öğesini kapat
curl_close($ch);

// Sunucudan gelen cevabı çözümle
$pyz_res = json_decode($hRet, true);

// Cevap kodunu kontrol et ve işlem yap
if ($pyz_res['code'] == 200) {
    print($hRet);
} else {
    exit("Access denied");
}

Başarılı Cevap

{
    "code": 200,
    "message": "Başarılı"
    "data": {
      "binNumber": "Your Card Bin Number",
      "amount": "1000.00",
      "type:": "0",
      "brand": "CARDFINANS",
      "family": "CARDFINANS",
      "bankName": "Finansbank A.Ş"
      "installments": [
          {
                  "commissionRate": 0,
                  "totalAmount": 1000,
                  "installmentAmount": "1000",
                  "installmentNumber": 1
          },
          {
                  "commissionRate": 5.96,
                  "totalAmount": 1059.6,
                  "installmentAmount": "59.6",
                  "installmentNumber": 2
          },
          {
                  "commissionRate": 7.83,
                  "totalAmount": 1078.3,
                  "installmentAmount": "78.3",
                  "installmentNumber": 3
          },
          {
                  "commissionRate": 9.7,
                  "totalAmount": 1097,
                  "installmentAmount": "97",
                  "installmentNumber": 4
          },
          {
                  "commissionRate": 11.56,
                  "totalAmount": 1115.6,
                  "installmentAmount": "115.6",
                  "installmentNumber": 5
          },
          {
                  "commissionRate": 13.43,
                  "totalAmount": 1134.3,
                  "installmentAmount": "134.3",
                  "installmentNumber": 6
          },
          {
                  "commissionRate": 15.3,
                  "totalAmount": 1153,
                  "installmentAmount": "153",
                  "installmentNumber": 7
          },
          {
                  "commissionRate": 10.03,
                  "totalAmount": 1100.3,
                  "installmentAmount": "110.3",
                  "installmentNumber": 8
          },
          {
                  "commissionRate": 19.04,
                  "totalAmount": 1190.4,
                  "installmentAmount": "190.4",
                  "installmentNumber": 9
          },
         {
                  "commissionRate": 20.91,
                  "totalAmount": 1209.1,
                  "installmentAmount": "209.1",
                  "installmentNumber": 10
          },
          {
                  "commissionRate": 22.78,
                  "totalAmount": 1227.8,
                  "installmentAmount": "227.8",
                  "installmentNumber": 11
          },
          {
                  "commissionRate": 24.65,
                  "totalAmount": 1246.5,
                  "installmentAmount": "246.5",
                  "installmentNumber": 12
          }
        ]
      }
    }
}

Değer Tür Açıklama
code integer Yapılan isteğin sonucunu bildirir. İşlem başarılı ise 200 döner.
card_number string Kredi kartı numarası
amount string Tutar.
store_comission string Mağazanın tek çekim komisyon oranı
installments array Karta yapılabilecek taksit listesi
details array Karta yapılabilecek taksit detayı
comission string Taksit sayısına göre belirlenen komisyon oranı.
total_amount string Taksit sayısına göre belirlenen komisyonlu toplam tutar.

Başarısız Cevap

{
    "code": 404,
    "message": " Invalid app_id or app_secret"
}

Değer Tür Açıklama
code integer Yapılan isteğin sonucunu bildirir. İşlem hatalı ise aşağıdaki kodlar döner.
message string Yapılan istekteki hata mesajını belirtir.

Hata Mesajları

Hata Kodu Hata Mesajı Açıklama
404 Mandatory parameters are missing Hatalı istek türü ya da zorunlu parametrelerden birisi eksik.
411 * is required Eksik gönderilen parametreler burada belirtilir.
404 Token is missing Bearer token gönderilmedi.
400 Access denied Bearer token hatalı yada süresi dolmuş.
408 Undefined Card Number Tanımlanmamış yada hatalı kart numarası.
403 Foreign Cards are not Allowed for this Merchant Mağazada yabancı kart kullanılamaz.
403 Undefined Pos ID Tanımlanmamış Pos.
406 getPos Error Pos hatası.
500 System Error Sistem hatası.
410 The credit card must be 16 digits Kart numarası 16 karakterden oluşmalı.
406 Merchant is not active Mağaza aktif değil.