Ekstra Taksit Bilgisi
- Ödeme sayfasında ekstra taksit sunabilmek için Payfull hesabınız içerisinde bu seçeneğin açılmış olması gerekmektedir. - Ekstra taksit konusu seçmiş olduğunuz installment/bank id/gateway/total/currency değerlerine bağlı olarak değişmektedir. - Bu işlem ekstra taksit bilgisini Payfull serverlarında sorgulatıp bilgi almanıza yarar.
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.
- exchange_rate: OPSİYONEL
- Payful içerisinde kur değerlerini öğrenmek istiyorsanız bu parametreye 1 değeri atamalısınız.
If you would like to know about currency exchange rate in Payfull, set this parameter to 1.
Buna bağlı olarak gelecek cevap Türk Lirasını 1 kabul ederek kur değerlerini çıkaracaktır. - currency: OPSİYONEL
- Eğer exchange_rate değerini 1 olarak atarsanız, bu parametre ZORUNLU hale gelir, seçilebilecek para birimleri USD/EUR/GBP şeklindedir.
- 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.
- - 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.
Güvenlik kodu (hash) değerini oluşturmak için aşağıdaki işlemler sırası ile gerçekleştirilmelidir;
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 ExtraInstallments olmalı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 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
- İş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.
- - 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.
Güvenlik kodu (hash) değerini oluşturmak için aşağıdaki işlemler sırası ile gerçekleştirilmelidir;
İstek Örneği
merchant: merchant name
type: Get
get_param: ExtraInstallmentsList
language: tr
client_ip: 192.168.1.1
hash: 14339MjuG01015018
Cevap Örneği
{
"status":1,
"ErrorMSG":"",
"ErrorCode":"00",
"data":
{
"campaigns"
[{
"campaign_name":"Campaign A",
"campaign_code":"2",
"campaign_id":"4",
"currency":TRY,
"bank_id":"YapiKredi"
"gateway":"10001"
"base_installments":"2"
"extra_installments":"4"
"min_amount":"0"
"status":"1"
},
{
"campaign_name":"Campaign B",
"campaign_code":"3",
"campaign_id":"5",
"currency":TRY,
"bank_id":"YapiKredi"
"gateway":"10001"
"base_installments":"2"
"extra_installments":"5"
"min_amount":"0"
"status":"1"
}]
}
}
Php Örneği