Kart Bilgisi Sorgulama

Kullanıcıya ait kartın bilgisini sormak için kullanıcak bir işlemdir.

Gerekli parametreler

merchant: ZORUNLU

Payfull hesabınız içerisinde(Ayarlar->Apı Hesapları) tanımladığınız Apı hesabına ait "Üye İşyeri Adı" alanına girilen değerdir.

type: ZORUNLU

İşlem tipi Get olmalıdır.

get_param: ZORUNLU

Parametre değeri ExtraInstallmentsList olmaldır.

bin: ZORUNLU

Kullanıcının kartınna ait BIN numarası. Kart numarasının ilk 6 ya da ilk 8 hanesi.

language: ZORUNLU

Satış işlemi sonrası gelecek olan cevabın dil seçeneğini belirlemekte kullanılır. İki seçenek vardır. en / tr

client_ip: ZORUNLU

İşlemi yapacak kişiye ait IP bilgisi gönderilmelidir.

hash: ZORUNLU

İşlemin hangi api kullanıcısına ait olduğunu anlamamız ve güvenlik için kullanılan Güvenlik kodu parametresidir. Nasıl oluşturulacağı aşağıda anlatılmış olup sayfanın sağ tarafındaki örnekte php örneği olarak gösterilmiştir.
‍
Güvenlik kodu (hash) değerini oluşturmak için aşağıdaki işlemler sırası ile gerçekleştirilmelidir;
‍
- Bütün parametrelerin oluşturulduğundan emin olun. Her senaryo için Güvenlik kodu (hash) oluşturma işlemi son işlem ve son parametreniz olmalıdır.
- Parametreleri alfabetik olarak A'dan Z'ye sıralayınız.
- Bir string değeri($siraliParametreler) oluşturup teker teker her parametrenizin uzunluğunu ve kendisini yanyana ekleyiniz.
- sha256 hash kodu üretici fonksiyon ile parametrelerinizden oluşturduğunuz ($siraliParametreler) string değerinizi ve Payfull hesabınızda belirlenen "Üye İşyeri Şifresi" ni kullanarak bir Güvenlik kodu üretiniz.
- Parametreleriniz içerisine parametre ismi "hash", değeri ise şimdi oluştuduğunuz Güvenlik kodunu yerleştirerek Api isteğinizi Endpoint Url'inize gönderiniz.

Ekstra Taksit Bilgisi (ödemeye özel)

Ödemeye özel ekstra taksit bilgisini aşağıdaki isteği yollayarak hemen öğrenebilirsiniz.

Gerekli parametreler

merchant: ZORUNLU

Payfull hesabınız içerisinde(Ayarlar->Apı Hesapları) tanımladığınız Apı hesabına ait "Üye İşyeri Adı" alanına girilen değerdir.

type: ZORUNLU

İşlem tipi Get olmalıdır.

get_param: ZORUNLU

Parametre değeri ExtraInstallmentsList olmaldır.

language: ZORUNLU

Satış işlemi sonrası gelecek olan cevabın dil seçeneğini belirlemekte kullanılır. İki seçenek vardır. en / tr

client_ip: ZORUNLU

İşlemi yapacak olan kişiye ait IP bilgisi gönderilmelidir.

total: ZORUNLU

Ödeme Tutarı.

currency: ZORUNLU

Desteklenen para birimleri şunlardır. TRY/USD/EUR/GBP

bank_id: ZORUNLU

Ödemenin yapılacağı banka bilgisine ihtiyaç duyulur.

gateway: ZORUNLU

bank_id ile beraber kullanılmak istenen bankaya ait özel bir değer girilmesi gerekir. İlgili değeri nasıl temin edeceğinizi Taksit Bilgisi sayfasından öğrenebilirsiniz.

installments: ZORUNLU

Taksit değerinin girildiği alanı ifade eder. Tek çekim işlem tapılacaksa değer 1 olarak atanmalıdır.

hash: ZORUNLU

> İstek Örneği

merchant : merchant name

type : Get

get_param: Issuer

bin: 435508

language : tr

client_ip: 192.168.1.1

hash: 14339MjuG01015018

> Cevap Örneği

{

“status”: 1,

“ErrorMSG”: "",

“ErrorCode”: "00",

“data”:

{

“brand”: "VISA",

“type”: "CREDIT",

“level”: "CLASSIC",

“network”: "AXESS",

“issuer”: "AKBANK T.A.S.",

“virtual”: "false",

“country”: "TUR",

“bank_id”: "Akbank",

“origin”: "Akbank",

“network”: "Array",

}

> Php Örneği

$api_url =
'https://yourSubDomain.payfull.com/integration/api/v1';

$merchantPassword = 'your merchant password';

  $params = array(
               "merchant" => 'your merchant name',
           "type" => 'Get',
                        "get_param" => 'Issuer',
                        "bin" => '435508',
‍
                 "language" => 'tr',
"client_ip" => '192.168.1.1'
);
// Hash kodu üretme yöntemi.
                    ksort($params);
$hashString = "";
foreach ($params as $key=>$val) {
                      $l = mb_strlen($val);
   if($l) $hashString .= $l . $val;
}

$params["hash"] = hash_hmac("sha256", $hashString, $merchantPassword);
// Hash kodu üretilip parametreler arasına "hash" index'i ile eklendi.

//curl sürecini başlatıyoruz.
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
                        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
                curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
               curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);                         curl_setopt($ch, CURLOPT_TIMEOUT, 60);
             curl_setopt($ch, CURLOPT_POST, 1);
   curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));

//curl için gerekli olan URL değeri ve parametreler hazırlandı ve curl_exec() fonksiyonu ile işlemi başlatıp cevabı $response değerine atıyoruz.

                        $response = curl_exec($ch);

         $curlerrcode = curl_errno($ch);
$curlerr = curl_error($ch);

       var_dump(json_decode($response));