Kart Kayıt İşlemi

‍

Kart kaydetme özelliği için karta ait bilgilerin tamamı payfula istek olarak gönderilir ve Payfull tarafından cevap bilgisi içerisinde TOKEN değeri dönülür. Token değeri kayıt edilmeli ve sonrasında kayıtlı kart ile satış yapılmak istenirse bu token yardımı ile kart bilgilerine ihtiyaç duyulmadan satış işlemi gerçekleştirilebilir. Ayrıca kart kaydı silinmek istenirse Token değerine yeniden ihtiyaç duyulacaktır.

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 Set olmalıdır.

‍set_param: ZORUNLU

‍Parametre değeri Card olmalıdır.

‍card_op: ZORUNLU

‍İki seçenk bulunmaktadır ekle veya çıkar şuan ekleme işlemi yapmaktayız o yüzden add olarak değer atanmalıdır.

user_email: ZORUNLU

‍Kart sahibi Payfull hesabı içerisinde üye olmalıdır. Böylelikle payful hesabı içerisindeki e-mail değeri bu parametre ile gönderilmelidir.

‍language: ZORUNLU

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

‍cc_name: ZORUNLU

‍Ücret Tahsil edilecek kişinin kart bilgilerine ihtiyaç vardır.Kart üzerinde yazan isim.

‍cc_number: ZORUNLU

‍16 haneli kart numarasıÖrnek olarak: 4123456789123456

‍cc_month: ZORUNLU

‍Kart Son Kullanım Tarihi Ay değeriÖrnek Olarak: 05

‍cc_year: ZORUNLU

‍Kart Son Kullanım Tarihi Yıl değeriÖrnek Olarak: 2017

cc_cvc: ZORUNLU

‍Kart Güvenlik NumarasıÖrnek Olarak: 000

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

‍

İstek Örneği

‍

merchant: merchant name
type: Set
set_param: Card
card_op: add
user_email: demo@gmail.com
cc_name: Mohammad
cc_number: 4111111111111111
cc_month: 12
cc_year: 2030
cc_cvc: 000
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[{"cc_token":"A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII"}]"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'add',

"user_email" => 'demo@gmail.com',

"cc_name" => 'Mohammad'

"cc_number" => '4111111111111111',

"cc_month" => '12',

"cc_year" => '2030',

"cc_cvc" => '000',

"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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

Kart Kaydı Silme

Bu işlem daha önceden kayıt edilmiş kartın silinmesi için kullanılır. Kart kaydı yapıldığında Payfull tarafından cevap bilgisi içerisinde gönderilen TOKEN değerine ihtiyaç duyulur.

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 Set olmalıdır.

‍set_param: ZORUNLU

‍Parametre değeri Card olmalıdır.‍

card_op: ZORUNLU

‍İki seçenek vardır ekle veya sil. Bu işlem için delete değerini atamalıyız.

‍user_email: ZORUNLU

‍Kart sahibi Payfull hesabı içerisinde üye olmalıdır. Böylelikle payful hesabı içerisindeki e-mail değeri bu parametre ile gönderilmelidir.

card_token: ZORUNLU

‍Payfull tarfından kart kayıt işlemine cevaben gönderilen TOKEN değeri atanmalıdır.

‍language: ZORUNLU

‍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

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.

‍

İstek Örneği

‍

merchant: merchant name
type: Set
set_param: Card
card_op: delete
user_email: demo@gmail.com
card_token: A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[]"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'delete',

"user_email" => 'demo@gmail.com',

"card_token" => 'A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII',

"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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

İstek Örneği

‍

merchant: merchant name
type: Sale
total: 23.02
cc_token: A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII
currency: TRY
installments: 1
language: tr
client_ip: 192.168.1.1
payment_title: just payemnt title
bank_id: Akbank
gateway: 160
customer_firstname: ALI
customer_lastname: MUHAMAD
customer_email: alitestemail@gmail.com
customer_phone: 5394659832
customer_tc: 12590326514
passive_data: just any passive data
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"type":"Sale",
"status":1,
"transaction_id":"T4U_7dd053f6b8_d9a58906b",
"ErrorMSG":"Success Transaction",
"ErrorCode":"00",
"passive_data":" just any passive data",
"original_currency":"TRY",
"total":23.02,
"currency":"TRY",
"conversion_rate":1,
"bank_id":"Akbank",
"use3d":0,
"installments":1,
"time":"08-09-2016 02:53:25"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Sale',

"total" => '1.01',

"cc_token" => 'A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII',

"currency" => 'TRY',

"installments" => 1,

"language" => 'tr',

"client_ip" => '192.168.1.1',

"payment_title" => 'test payment title',

"bank_id" => 'Akbank',

"gateway" => '160',

"customer_firstname" => 'ALI',

"customer_lastname" => 'MUHAMAD',

"customer_email" => 'alitestemail@gmail.com',

"customer_phone" => '5394659832',

"customer_tc" => '12590326514',

"passive_data" => 'write here what you like',

);

// 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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

Kart Kayıt İşlemi

‍

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 Set olmalıdır.

‍set_param: ZORUNLU

‍Parametre değeri Card olmalıdır.

‍card_op: ZORUNLU

‍İki seçenk bulunmaktadır ekle veya çıkar şuan ekleme işlemi yapmaktayız o yüzden add olarak değer atanmalıdır.

user_email: ZORUNLU

‍Kart sahibi Payfull hesabı içerisinde üye olmalıdır. Böylelikle payful hesabı içerisindeki e-mail değeri bu parametre ile gönderilmelidir.

‍language: ZORUNLU

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

‍cc_name: ZORUNLU

‍Ücret Tahsil edilecek kişinin kart bilgilerine ihtiyaç vardır.Kart üzerinde yazan isim.

‍cc_number: ZORUNLU

‍16 haneli kart numarasıÖrnek olarak: 4123456789123456

‍cc_month: ZORUNLU

‍Kart Son Kullanım Tarihi Ay değeriÖrnek Olarak: 05

‍cc_year: ZORUNLU

‍Kart Son Kullanım Tarihi Yıl değeriÖrnek Olarak: 2017

cc_cvc: ZORUNLU

‍Kart Güvenlik NumarasıÖrnek Olarak: 000

‍hash: ZORUNLU

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

‍

İstek Örneği

‍

merchant: merchant name
type: Set
set_param: Card
card_op: add
user_email: demo@gmail.com
cc_name: Mohammad
cc_number: 4111111111111111
cc_month: 12
cc_year: 2030
cc_cvc: 000
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[{"cc_token":"A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII"}]"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'add',

"user_email" => 'demo@gmail.com',

"cc_name" => 'Mohammad'

"cc_number" => '4111111111111111',

"cc_month" => '12',

"cc_year" => '2030',

"cc_cvc" => '000',

"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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

Kart Kaydı Silme

Bu işlem daha önceden kayıt edilmiş kartın silinmesi için kullanılır. Kart kaydı yapıldığında Payfull tarafından cevap bilgisi içerisinde gönderilen TOKEN değerine ihtiyaç duyulur.

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 Set olmalıdır.

‍set_param: ZORUNLU

‍Parametre değeri Card olmalıdır.‍

card_op: ZORUNLU

‍İki seçenek vardır ekle veya sil. Bu işlem için delete değerini atamalıyız.

‍user_email: ZORUNLU

‍Kart sahibi Payfull hesabı içerisinde üye olmalıdır. Böylelikle payful hesabı içerisindeki e-mail değeri bu parametre ile gönderilmelidir.

card_token: ZORUNLU

‍Payfull tarfından kart kayıt işlemine cevaben gönderilen TOKEN değeri atanmalıdır.

‍language: ZORUNLU

‍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

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.

‍

İstek Örneği

‍

merchant: merchant name
type: Set
set_param: Card
card_op: delete
user_email: demo@gmail.com
card_token: A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[]"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'delete',

"user_email" => 'demo@gmail.com',

"card_token" => 'A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII',

"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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

Kart Kayıt İşlemi

‍

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 Set olmalıdır.

‍set_param: ZORUNLU

‍Parametre değeri Card olmalıdır.

‍card_op: ZORUNLU

‍İki seçenk bulunmaktadır ekle veya çıkar şuan ekleme işlemi yapmaktayız o yüzden add olarak değer atanmalıdır.

user_email: ZORUNLU

‍Kart sahibi Payfull hesabı içerisinde üye olmalıdır. Böylelikle payful hesabı içerisindeki e-mail değeri bu parametre ile gönderilmelidir.

‍language: ZORUNLU

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

‍cc_name: ZORUNLU

‍Ücret Tahsil edilecek kişinin kart bilgilerine ihtiyaç vardır.Kart üzerinde yazan isim.

‍cc_number: ZORUNLU

‍16 haneli kart numarasıÖrnek olarak: 4123456789123456

‍cc_month: ZORUNLU

‍Kart Son Kullanım Tarihi Ay değeriÖrnek Olarak: 05

‍cc_year: ZORUNLU

‍Kart Son Kullanım Tarihi Yıl değeriÖrnek Olarak: 2017

cc_cvc: ZORUNLU

‍Kart Güvenlik NumarasıÖrnek Olarak: 000

‍hash: ZORUNLU

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

‍

İstek Örneği

‍

merchant: merchant name
type: Set
set_param: Card
card_op: add
user_email: demo@gmail.com
cc_name: Mohammad
cc_number: 4111111111111111
cc_month: 12
cc_year: 2030
cc_cvc: 000
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[{"cc_token":"A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII"}]"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'add',

"user_email" => 'demo@gmail.com',

"cc_name" => 'Mohammad'

"cc_number" => '4111111111111111',

"cc_month" => '12',

"cc_year" => '2030',

"cc_cvc" => '000',

"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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

Kart Kaydı Silme

Bu işlem daha önceden kayıt edilmiş kartın silinmesi için kullanılır. Kart kaydı yapıldığında Payfull tarafından cevap bilgisi içerisinde gönderilen TOKEN değerine ihtiyaç duyulur.

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 Set olmalıdır.

‍set_param: ZORUNLU

‍Parametre değeri Card olmalıdır.‍

card_op: ZORUNLU

‍İki seçenek vardır ekle veya sil. Bu işlem için delete değerini atamalıyız.

‍user_email: ZORUNLU

‍Kart sahibi Payfull hesabı içerisinde üye olmalıdır. Böylelikle payful hesabı içerisindeki e-mail değeri bu parametre ile gönderilmelidir.

card_token: ZORUNLU

‍Payfull tarfından kart kayıt işlemine cevaben gönderilen TOKEN değeri atanmalıdır.

‍language: ZORUNLU

‍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

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.

‍

İstek Örneği

‍

merchant: merchant name
type: Set
set_param: Card
card_op: delete
user_email: demo@gmail.com
card_token: A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[]"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'delete',

"user_email" => 'demo@gmail.com',

"card_token" => 'A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII',

"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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

kayıtlı Kart İle Satış İşlemi [TOKEN]

- Satış işlemi kart bilgileri girmeden sadece ilgili karta ait TOKEN değeri gönderilerek gerçekleştirilebilir.
- Taksitli işlem yapılmak istenirse installments parametresi kullanılarak taksit değeri belirlenir.Ayrıca bank_di, gateway parametreleride zorunlu hale gelir.
- Taksitli işlem yapmadan önce taksit imkanlarınız, banka_id ve gateway değerlerini bilmeniz gerekmektedir.

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 Sale olmalıdır.

‍total: ZORUNLU

‍Ödemenin miktarında kuruş değeride belirtilmelidir. Örnek olarak: 10.23 yada 10.00

‍cc_token: ZORUNLU

‍kart kayıt işlemine dönen cevap içerisinde bulunan TOKEN değeri atanmalıdır.

currency: ZORUNLU

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

‍installments: ZORUNLU

‍Taksit değerinin girildiği alanı ifade eder. Tek çekim işlem tapılacaksa değer 1 olarak atanmalıdı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(parayı ödeyecek) olan kişiye ait IP bilgisi gönderilmelidir.

‍payment_title: ZORUNLU

‍Her satış işlemine ait belirlenmesi gereken işlem başlığıdır. Örnek olarak: Çay Bardağı 6'lı Set

‍bank_id: OPSİYONEL

‍bank_id değeri zorunlu değildir. Ancak taksitli işlem yapılmak istendiğinde ZORUNLU hale gelir.
Taksitli işlemin hangi bankadan yapılmasını istiyorsanız o bankanın bank_id değerini göndermeniz gerekmektedir. İlgili değeri nasıl temin edeceğinizi Taksit Bilgisi sayfasından öğrenebilirsiniz.

‍gateway: OPSİYONEL

‍Taksitli işlem yapılmak istenildiğinde ZORUNLU olan bir parametre daha. 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.

customer_firstname: ZORUNLU

‍İşlemi yapan kişinin bilgilerine ihtiyaç vardır. İlk olarak isim.

‍customer_lastname: ZORUNLU

‍Soyisim‍

customer_email: ZORUNLU

‍Email hesabı

‍customer_phone: ZORUNLU

‍Telefon numarası

‍customer_tc: OPSİYONEL

‍TC kimlik numarası.

‍passive_data: OPSİYONEL

‍Bu parametre işlem için göndermek ve sonrasında tekrar geri almak istediğiniz herhangi data yada bilgi için oluşturulmuş bir parametredir.

‍hash: ZORUNLU

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.

‍

İstek Örneği

‍

merchant: merchant name
type: Sale
total: 23.02
cc_token: A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII
currency: TRY
installments: 1
language: tr
client_ip: 192.168.1.1
payment_title: just payemnt title
bank_id: Akbank
gateway: 160
customer_firstname: ALI
customer_lastname: MUHAMAD
customer_email: alitestemail@gmail.com
customer_phone: 5394659832
customer_tc: 12590326514
passive_data: just any passive data
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"type":"Sale",
"status":1,
"transaction_id":"T4U_7dd053f6b8_d9a58906b",
"ErrorMSG":"Success Transaction",
"ErrorCode":"00",
"passive_data":" just any passive data",
"original_currency":"TRY",
"total":23.02,
"currency":"TRY",
"conversion_rate":1,
"bank_id":"Akbank",
"use3d":0,
"installments":1,
"time":"08-09-2016 02:53:25"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Sale',

"total" => '1.01',

"cc_token" => 'A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII',

"currency" => 'TRY',

"installments" => 1,

"language" => 'tr',

"client_ip" => '192.168.1.1',

"payment_title" => 'test payment title',

"bank_id" => 'Akbank',

"gateway" => '160',

"customer_firstname" => 'ALI',

"customer_lastname" => 'MUHAMAD',

"customer_email" => 'alitestemail@gmail.com',

"customer_phone" => '5394659832',

"customer_tc" => '12590326514',

"passive_data" => 'write here what you like',

);

// 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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

Kart Kayıt İşlemi

‍

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 Set olmalıdır.

‍set_param: ZORUNLU

‍Parametre değeri Card olmalıdır.

‍card_op: ZORUNLU

‍İki seçenk bulunmaktadır ekle veya çıkar şuan ekleme işlemi yapmaktayız o yüzden add olarak değer atanmalıdır.

user_email: ZORUNLU

‍Kart sahibi Payfull hesabı içerisinde üye olmalıdır. Böylelikle payful hesabı içerisindeki e-mail değeri bu parametre ile gönderilmelidir.

‍language: ZORUNLU

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

‍cc_name: ZORUNLU

‍Ücret Tahsil edilecek kişinin kart bilgilerine ihtiyaç vardır.Kart üzerinde yazan isim.

‍cc_number: ZORUNLU

‍16 haneli kart numarasıÖrnek olarak: 4123456789123456

‍cc_month: ZORUNLU

‍Kart Son Kullanım Tarihi Ay değeriÖrnek Olarak: 05

‍cc_year: ZORUNLU

‍Kart Son Kullanım Tarihi Yıl değeriÖrnek Olarak: 2017

cc_cvc: ZORUNLU

‍Kart Güvenlik NumarasıÖrnek Olarak: 000

‍hash: ZORUNLU

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

‍

İstek Örneği

‍

merchant: merchant name
type: Set
set_param: Card
card_op: add
user_email: demo@gmail.com
cc_name: Mohammad
cc_number: 4111111111111111
cc_month: 12
cc_year: 2030
cc_cvc: 000
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[{"cc_token":"A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII"}]"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'add',

"user_email" => 'demo@gmail.com',

"cc_name" => 'Mohammad'

"cc_number" => '4111111111111111',

"cc_month" => '12',

"cc_year" => '2030',

"cc_cvc" => '000',

"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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

Kart Kaydı Silme

Bu işlem daha önceden kayıt edilmiş kartın silinmesi için kullanılır. Kart kaydı yapıldığında Payfull tarafından cevap bilgisi içerisinde gönderilen TOKEN değerine ihtiyaç duyulur.

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 Set olmalıdır.

‍set_param: ZORUNLU

‍Parametre değeri Card olmalıdır.‍

card_op: ZORUNLU

‍İki seçenek vardır ekle veya sil. Bu işlem için delete değerini atamalıyız.

‍user_email: ZORUNLU

‍Kart sahibi Payfull hesabı içerisinde üye olmalıdır. Böylelikle payful hesabı içerisindeki e-mail değeri bu parametre ile gönderilmelidir.

card_token: ZORUNLU

‍Payfull tarfından kart kayıt işlemine cevaben gönderilen TOKEN değeri atanmalıdır.

‍language: ZORUNLU

‍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

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.

‍

İstek Örneği

‍

merchant: merchant name
type: Set
set_param: Card
card_op: delete
user_email: demo@gmail.com
card_token: A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[]"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'delete',

"user_email" => 'demo@gmail.com',

"card_token" => 'A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII',

"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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

kayıtlı Kart İle Satış İşlemi [TOKEN]

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 Sale olmalıdır.

‍total: ZORUNLU

‍Ödemenin miktarında kuruş değeride belirtilmelidir. Örnek olarak: 10.23 yada 10.00

‍cc_token: ZORUNLU

‍kart kayıt işlemine dönen cevap içerisinde bulunan TOKEN değeri atanmalıdır.

currency: ZORUNLU

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

‍installments: ZORUNLU

‍Taksit değerinin girildiği alanı ifade eder. Tek çekim işlem tapılacaksa değer 1 olarak atanmalıdı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(parayı ödeyecek) olan kişiye ait IP bilgisi gönderilmelidir.

‍payment_title: ZORUNLU

‍Her satış işlemine ait belirlenmesi gereken işlem başlığıdır. Örnek olarak: Çay Bardağı 6'lı Set

‍bank_id: OPSİYONEL

‍gateway: OPSİYONEL

customer_firstname: ZORUNLU

‍İşlemi yapan kişinin bilgilerine ihtiyaç vardır. İlk olarak isim.

‍customer_lastname: ZORUNLU

‍Soyisim‍

customer_email: ZORUNLU

‍Email hesabı

‍customer_phone: ZORUNLU

‍Telefon numarası

‍customer_tc: OPSİYONEL

‍TC kimlik numarası.

‍passive_data: OPSİYONEL

‍Bu parametre işlem için göndermek ve sonrasında tekrar geri almak istediğiniz herhangi data yada bilgi için oluşturulmuş bir parametredir.

‍hash: ZORUNLU

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.

‍

İstek Örneği

‍

merchant: merchant name
type: Sale
total: 23.02
cc_token: A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII
currency: TRY
installments: 1
language: tr
client_ip: 192.168.1.1
payment_title: just payemnt title
bank_id: Akbank
gateway: 160
customer_firstname: ALI
customer_lastname: MUHAMAD
customer_email: alitestemail@gmail.com
customer_phone: 5394659832
customer_tc: 12590326514
passive_data: just any passive data
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"type":"Sale",
"status":1,
"transaction_id":"T4U_7dd053f6b8_d9a58906b",
"ErrorMSG":"Success Transaction",
"ErrorCode":"00",
"passive_data":" just any passive data",
"original_currency":"TRY",
"total":23.02,
"currency":"TRY",
"conversion_rate":1,
"bank_id":"Akbank",
"use3d":0,
"installments":1,
"time":"08-09-2016 02:53:25"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Sale',

"total" => '1.01',

"cc_token" => 'A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII',

"currency" => 'TRY',

"installments" => 1,

"language" => 'tr',

"client_ip" => '192.168.1.1',

"payment_title" => 'test payment title',

"bank_id" => 'Akbank',

"gateway" => '160',

"customer_firstname" => 'ALI',

"customer_lastname" => 'MUHAMAD',

"customer_email" => 'alitestemail@gmail.com',

"customer_phone" => '5394659832',

"customer_tc" => '12590326514',

"passive_data" => 'write here what you like',

);

// 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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

Kart Kayıt İşlemi

‍

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 Set olmalıdır.

‍set_param: ZORUNLU

‍Parametre değeri Card olmalıdır.

‍card_op: ZORUNLU

‍İki seçenk bulunmaktadır ekle veya çıkar şuan ekleme işlemi yapmaktayız o yüzden add olarak değer atanmalıdır.

user_email: ZORUNLU

‍Kart sahibi Payfull hesabı içerisinde üye olmalıdır. Böylelikle payful hesabı içerisindeki e-mail değeri bu parametre ile gönderilmelidir.

‍language: ZORUNLU

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

‍cc_name: ZORUNLU

‍Ücret Tahsil edilecek kişinin kart bilgilerine ihtiyaç vardır.Kart üzerinde yazan isim.

‍cc_number: ZORUNLU

‍16 haneli kart numarasıÖrnek olarak: 4123456789123456

‍cc_month: ZORUNLU

‍Kart Son Kullanım Tarihi Ay değeriÖrnek Olarak: 05

‍cc_year: ZORUNLU

‍Kart Son Kullanım Tarihi Yıl değeriÖrnek Olarak: 2017

cc_cvc: ZORUNLU

‍Kart Güvenlik NumarasıÖrnek Olarak: 000

‍hash: ZORUNLU

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

‍

İstek Örneği

‍

merchant: merchant name
type: Set
set_param: Card
card_op: add
user_email: demo@gmail.com
cc_name: Mohammad
cc_number: 4111111111111111
cc_month: 12
cc_year: 2030
cc_cvc: 000
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[{"cc_token":"A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII"}]"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'add',

"user_email" => 'demo@gmail.com',

"cc_name" => 'Mohammad'

"cc_number" => '4111111111111111',

"cc_month" => '12',

"cc_year" => '2030',

"cc_cvc" => '000',

"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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

Kart Kayıt İşlemi

‍

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 Set olmalıdır.

‍set_param: ZORUNLU

‍Parametre değeri Card olmalıdır.

‍card_op: ZORUNLU

‍İki seçenk bulunmaktadır ekle veya çıkar şuan ekleme işlemi yapmaktayız o yüzden add olarak değer atanmalıdır.

user_email: ZORUNLU

‍Kart sahibi Payfull hesabı içerisinde üye olmalıdır. Böylelikle payful hesabı içerisindeki e-mail değeri bu parametre ile gönderilmelidir.

‍language: ZORUNLU

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

‍cc_name: ZORUNLU

‍Ücret Tahsil edilecek kişinin kart bilgilerine ihtiyaç vardır.Kart üzerinde yazan isim.

‍cc_number: ZORUNLU

‍16 haneli kart numarasıÖrnek olarak: 4123456789123456

‍cc_month: ZORUNLU

‍Kart Son Kullanım Tarihi Ay değeriÖrnek Olarak: 05

‍cc_year: ZORUNLU

‍Kart Son Kullanım Tarihi Yıl değeriÖrnek Olarak: 2017

cc_cvc: ZORUNLU

‍Kart Güvenlik NumarasıÖrnek Olarak: 000

‍hash: ZORUNLU

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

‍

İstek Örneği

‍

merchant: merchant name
type: Set
set_param: Card
card_op: add
user_email: demo@gmail.com
cc_name: Mohammad
cc_number: 4111111111111111
cc_month: 12
cc_year: 2030
cc_cvc: 000
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[{"cc_token":"A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII"}]"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'add',

"user_email" => 'demo@gmail.com',

"cc_name" => 'Mohammad'

"cc_number" => '4111111111111111',

"cc_month" => '12',

"cc_year" => '2030',

"cc_cvc" => '000',

"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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

Kart Kayıt İşlemi

‍

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 Set olmalıdır.

‍set_param: ZORUNLU

‍Parametre değeri Card olmalıdır.

‍card_op: ZORUNLU

‍İki seçenk bulunmaktadır ekle veya çıkar şuan ekleme işlemi yapmaktayız o yüzden add olarak değer atanmalıdır.

user_email: ZORUNLU

‍Kart sahibi Payfull hesabı içerisinde üye olmalıdır. Böylelikle payful hesabı içerisindeki e-mail değeri bu parametre ile gönderilmelidir.

‍language: ZORUNLU

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

‍cc_name: ZORUNLU

‍Ücret Tahsil edilecek kişinin kart bilgilerine ihtiyaç vardır.Kart üzerinde yazan isim.

‍cc_number: ZORUNLU

‍16 haneli kart numarasıÖrnek olarak: 4123456789123456

‍cc_month: ZORUNLU

‍Kart Son Kullanım Tarihi Ay değeriÖrnek Olarak: 05

‍cc_year: ZORUNLU

‍Kart Son Kullanım Tarihi Yıl değeriÖrnek Olarak: 2017

cc_cvc: ZORUNLU

‍Kart Güvenlik NumarasıÖrnek Olarak: 000

‍hash: ZORUNLU

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

‍

İstek Örneği

‍

merchant: merchant name
type: Set
set_param: Card
card_op: add
user_email: demo@gmail.com
cc_name: Mohammad
cc_number: 4111111111111111
cc_month: 12
cc_year: 2030
cc_cvc: 000
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[{"cc_token":"A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII"}]"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'add',

"user_email" => 'demo@gmail.com',

"cc_name" => 'Mohammad'

"cc_number" => '4111111111111111',

"cc_month" => '12',

"cc_year" => '2030',

"cc_cvc" => '000',

"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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

BANKA

KART NUMARASI

SON KULLANMA TARİHİ

CVV

AKBANK-vISA

4355084355084358

12/2030

000

AKBANK-MASTER

5571135571135575

12/2030

000

TEB-VISA

4402934402934406

12/2030

000

TEB-MASTER

5101385101385104

12/2030

000

HALKBANK-VISA

4920244920244921

12/2030

001

HALKBANK-MASTER

5404355404355405

12/2030

001

FINANSBANK-VISA

4022774022774026

12/2030

000

FINANSBANK-MASTER

5456165456165454

12/2030

000

ISBANK-VISA

4508034508034509

12/2030

000

ISBANK-MASTER

5406675406675403

12/2030

000

ANADOLUBANK-VISA

4258464258464253

12/2030

000

ANADOLUBANK-MASTER

5222405222405229

12/2030

000

KUVEYTTURK-VISA

4025894025894022

12/2030

000

INGBANK-VISA

4555714555714556

12/2030

000

INGBANK-MASTER

5400245400245409

12/2030

000

GARANTI

5342614723204016

06/2020

599

YKB

4506347048543223

08/2019

000

4506347011448053

02/2020

000

4506347022052795

02/2020

000

4506347031187533

02/2020

000

4506347043358536

02/2020

000

4921307045825277

02/2020

000

5400610093155852

02/2020

000

5400617049774124

02/2020

000

5400637003737156

02/2020

000

VAKIBANK

4938410114062912

01/2020

956

HSBC

5100051016005572

01/2020

742

KOMBANK-VISA

4920244920244913

01/2018

000

KOMBANK-MASTERCARD

5404355404355405

01/2018

000

MOKA

5259222233334444

12/2030

000

Iyzico

https://github.com/iyzico/iyzipay-php

FINANSBANK - TROY

9792023757123604

01/2026

861

TURK ELEKTRONIK PARA - TROY

9792350046201275

07/2027

993

VAKIFBANK - TROY

6501700194147183

03/2023

136

VAKIFBANK - TROY

6500528865390837

01/2021

686

AKBANK - TROY

9792072000017956

01/2020

843

Kart Kayıt İşlemi

‍

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 Set olmalıdır.

‍set_param: ZORUNLU

‍Parametre değeri Card olmalıdır.

‍card_op: ZORUNLU

‍İki seçenk bulunmaktadır ekle veya çıkar şuan ekleme işlemi yapmaktayız o yüzden add olarak değer atanmalıdır.

user_email: ZORUNLU

‍Kart sahibi Payfull hesabı içerisinde üye olmalıdır. Böylelikle payful hesabı içerisindeki e-mail değeri bu parametre ile gönderilmelidir.

‍language: ZORUNLU

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

‍cc_name: ZORUNLU

‍Ücret Tahsil edilecek kişinin kart bilgilerine ihtiyaç vardır.Kart üzerinde yazan isim.

‍cc_number: ZORUNLU

‍16 haneli kart numarasıÖrnek olarak: 4123456789123456

‍cc_month: ZORUNLU

‍Kart Son Kullanım Tarihi Ay değeriÖrnek Olarak: 05

‍cc_year: ZORUNLU

‍Kart Son Kullanım Tarihi Yıl değeriÖrnek Olarak: 2017

cc_cvc: ZORUNLU

‍Kart Güvenlik NumarasıÖrnek Olarak: 000

‍hash: ZORUNLU

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

‍

İstek Örneği

‍

merchant: merchant name
type: Set
set_param: Card
card_op: add
user_email: demo@gmail.com
cc_name: Mohammad
cc_number: 4111111111111111
cc_month: 12
cc_year: 2030
cc_cvc: 000
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[{"cc_token":"A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII"}]"
}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'add',

"user_email" => 'demo@gmail.com',

"cc_name" => 'Mohammad'

"cc_number" => '4111111111111111',

"cc_month" => '12',

"cc_year" => '2030',

"cc_cvc" => '000',

"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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

Banka/Ödeme Kuruluşu

Parametre Adı

Parametre Değeri

Garanti

Üye İşyeri ID

7000679

Secure Key

123qweASD

Terminal ID

30691297

3D Anahtarı

12345678

PROVAUT

123qweASD

PROVRFN

123qweASD

Akbank

API Üye İş Yeri ID

100658785

API Şifresi

TEST1111

API Kullanıcı Adı

api

3D Anahtarı

123456

Finansbank

API Üye İş Yeri ID

600658785

API Şifresi

TEST1111

API Kullanıcı Adı

api

3D Anahtarı

123456

Halkbank

API Üye İş Yeri ID

500658785

API Şifresi

TEST1111

API Kullanıcı Adı

api

3D Anahtarı

123456

HSBC

API Üye İş Yeri ID

100658785

API Şifresi

TEST1111

API Kullanıcı Adı

api

3D Anahtarı

123456

Iysico

Create SandBox account at https://sandbox-merchant.iyzipay.com/login

PayU

Üye İşyeri

OPU_TEST

Şifre

SECRET_KEY

BKM Express

Üye İşyeri
ID

9d6818c5-8da5-4072-db17-c7f559b44aeb

Özel Anahtar

Lütfen kendi private key değerinizi
oluşturup BKM ile paylaşınız.

BKM Açık Anahtar

lüften BKM ile bağlantı kurup,
Public key değerlerini alıp kendi tarfınıza ekleyin

MOKA

dealerCode

Username

PayfullTest

Password

HS7D7329OD9DJ

Compay

Client ID

104000046

Sale Password

Test1234

Api Kullanıcı Adı

payfullapi

Api Parola

payfullapi

Kart Kayıt İşlemi

Gerekli Parametreler

İstek Örneği

merchant: merchant nametype: Setset_param: Cardcard_op: adduser_email: demo@gmail.comcc_name: Mohammadcc_number: 4111111111111111cc_month: 12cc_year: 2030cc_cvc: 000language: trclient_ip: 192.168.1.1hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{"status":1,"ErrorMSG":"","ErrorCode":"00","data":"[{"cc_token":"A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII"}]"}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'add',

"user_email" => 'demo@gmail.com',

"cc_name" => 'Mohammad'

"cc_number" => '4111111111111111',

"cc_month" => '12',

"cc_year" => '2030',

"cc_cvc" => '000',

"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);

//cevabı öğrenmek için print ediyoruz.

var_dump(json_decode($response));

‍

Kart Kaydı Silme

Gerekli Parametreler

İstek Örneği

merchant: merchant nametype: Setset_param: Cardcard_op: deleteuser_email: demo@gmail.comcard_token: A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BIIlanguage: trclient_ip: 192.168.1.1hash: 14339MjuG01015018

‍

Cevap Örneği

‍

{"status":1,"ErrorMSG":"","ErrorCode":"00","data":"[]"}

PHP Örneği

//API isteğini göndereceğiniz Endpoint URL değeri

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

//Payfull hesabınız içerisinde oluştuduğunuz API hesabına ait "Üye İşyeri Şifresi" değeri.

$merchantPassword = 'your merchant password';

//parametrelerinizi oluşturduğunuz dizi.

$params = array(

"merchant" => 'your merchant name',

"type" => 'Set',

"set_param" => 'Card',

"card_op" => 'delete',

"user_email" => 'demo@gmail.com',

"card_token" => 'A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII',

"language" => 'tr',

"client_ip" => '192.168.1.1',

);

// Hash kodu üretme yöntemi.

ksort($params);

$hashString = "";

merchant: merchant name
type: Set
set_param: Card
card_op: add
user_email: demo@gmail.com
cc_name: Mohammad
cc_number: 4111111111111111
cc_month: 12
cc_year: 2030
cc_cvc: 000
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[{"cc_token":"A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII"}]"
}

merchant: merchant name
type: Set
set_param: Card
card_op: delete
user_email: demo@gmail.com
card_token: A5NVH5VFTXE3XT3DUTVJMTD2BR2U7K5LBS2UNOXFTA5W2BII
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018

{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":"[]"
}