Satış - 3D Kullanmadan

- Satış işlemi ilgili kredi kartından anında ücret tahsil eden işlemdir.
- Taksitli işlem yapılmak istenirse installments parametresi kullanılarak taksit değeri belirlenir. Ayrıca bank_id, 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
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.
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.
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.
payment_title: ZORUNLU: Her satış işlemine ait belirlenmesi gereken işlem başlığıdır. Örnek olarak: Çay Bardağı 6'lı Set
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
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ı
campaign_id: OPSİYONEL: Belirli bankalar belirli koşullar yerine geldiğinde taksit değerlerinde kampanyalar oluşturmaktadır. Kampanyadan faydalanılmak istenirse ilgili id bilgisini göndermeniz gerekmektedir.
Buradan kampanyalara ait tüm bilgiye ulaşabilirsiniz.
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.
(not: lütfen bunu kart numaraları veya şifreler gibi önemli bir veri göndermek için kullanmayın).
merchant_trx_id: OPSİYONEL: Bu parametre işlem için özgün bir id değeri tanımlamanız ve göndermeniz içindir. Sonrasında üretmiş olduğunuz bu değeri İşlem Durum Bilgisi için kullanmanız gerekmektedir.
pre_auth: optional: If this parameter is set to 1, then this transaction will be pre-authorization transaction.
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.

BKM Express ile Satış İşlemi

- BKM Express kullanılarak satış işlemi gerçekleştirmek için ilgili parametleri hazırlamanız gerekmektedir.
- Bu satış işleminde kart bilgilerini göndermeniz gerekmemektedir.
- Bu işlemin cevabı eğer başarısız ise JSON formatında gelicektir. Eğer Başarılı olursa HTML formatında gelicektir.

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
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 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: ZORUNLU: Bu işlem için bank_id parametreniz BKMExpress'e ait olmalıdır. bank_id değerlerini öğrenmek için tıklayınız.
return_url: ZORUNLU: BKM express ten gelecek cevabın gönderileceği URL'i girmelisiniz.
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.
merchant_trx_id: OPSİYONEL: Bu parametre işlem için özgün bir id değeri tanımlamanız ve göndermeniz içindir. Sonrasında üretmiş olduğunuz bu değeri İşlem Durum Bilgisi için kullanmanız gerekmektedir.
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.

Compay ile Satış İşlemi

- Compay kullanılarak satış işlemi gerçekleştirmek için ilgili parametleri hazırlamanız gerekmektedir.
- Bu satış işleminde kart bilgilerini göndermeniz gerekmemektedir.
- Bu işlemin cevabı eğer başarısız ise JSON formatında gelicektir. Eğer Başarılı olursa HTML formatında gelicektir.

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
installments: ZORUNLU: Değer 1 olarak atanmalıdır.
currency: ZORUNLU: Desteklenen para birimleri şunlardır. TRY/USD/EUR/GBP
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.
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: ZORUNLU: Bu işlem için bank_id parametreniz Compay olmalıdır. bank_id değerlerini öğrenmek için tıklayınız.
return_url: ZORUNLU: Compay'den gelecek cevabın gönderileceği URL'i girmelisiniz.
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.
merchant_trx_id: OPSİYONEL: Bu parametre işlem için özgün bir id değeri tanımlamanız ve göndermeniz içindir. Sonrasında üretmiş olduğunuz bu değeri İşlem Durum Bilgisi için kullanmanız gerekmektedir.
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.

İstek Örneği

merchant: merchant name
type: Sale
total: 23.02
cc_name: ALI
cc_number: 4111111111111111
cc_month: 09
cc_year: 2024
cc_cvc: 000
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_name" => 'Mohammad', "cc_number" => '4111111111111111', "cc_month" => '12', "cc_year" => '2030', "cc_cvc" => '000', "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));