TR EN


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.

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

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: 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