TR EN


İptal İşlemi



İptal işlemi her işlemi iptal edebilir yalnızca kendisini iptal edemez. İptal işlemini iptal edemezsiniz. İptal işlemi içinde başarılı cevap alacaksınız ancak işlem günsonu yapılmışsa iptal işlemi geçerli olmayacaktır. Yapılan satış işlemini iptal edemezseniz. İade işlemi yapmak zorunda kalacaksınız.


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 Cancel olmalı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.

transaction_id: required
Payfull tarafından her satış işlemi için bir transaction id değeri oluşturulup cevap kısmında geri gönderilir. İptalini istediğiniz işlemin transaction id değerini göndermelisiniz.

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.

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: Cancel
language: tr
client_ip: 192.168.1.1
transaction_id: T4U_8d8125d10a_481a77f38
passive_data: just any passive data
hash: 14339MjuG01015018



Cevap Örneği


{
"type":"Cancel",
"status":1,
"transaction_id":"16252PLnE01010438",
"ErrorMSG":"Success Transaction",
"ErrorCode":"00",
"passive_data":just any passive data,
"total":"10.01",
"currency":"TRY",
"bank_id":"Akbank",
"time":"08-09-2016 03:13:16"
}


Php Örneği