Önprovizyon olarak başlatılan bir işlemin daha sonra satışa çevrilmesidir. Satışa çevrilen tutar kart hamilinin ekstresine yansıyacaktır. Önprovizyonu satışa çevirme işlemi tamamlandığında, gün sonu işleminden sonra işyeri hesabına ilgili tutar aktarılacaktır.
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 Capture 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: ZORUNLU
Payfull tarafından üretilip Satış işlemi sonrası cevap bilgisinde geri gönderilir.
total: ZORUNLU
Ödemenin miktarında kuruş değeride belirtilmelidir. Örnek olarak: 10.23 yada 10.00
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;
- 3D Secure güvenlik satış İşleminde, normal satıştan farklı olarak use3d ve return_url olmak üzere iki ekstra parametre bulunur.
- Ayrıca lütfen TOKEN ve taksitlerin kullanılacağını öğrenmek/görmek için Satış İşlemi sayfasını kontrol edin.
- Aşama A:Satış isteği gönderirken use3d ve return_url ile birlikte göndermeniz gerekir.
- Aşama B: bağlantı isteği güvenli bir şekilde kurulursa HTML yanıtı alırsınız.
- Aşama C: : Dönen cevabı tarayıcıya HTML olarak yazdırmanız gerekir; bu sayede 3D doğrulama sayfası tarayıcınızda (OTP girişi yapılacak ekran) görünür ve kart sahibi işleme devam edebilir.
- Aşama D: Kart sahibi 3D şifresini ekrana başarılı olarak girdikten sonra, Payfull response mesajını (JSON formatında) return_url’nize döner.
Önemli notlar
- 3D isteği güvenli bir şekilde kurulmazsa, B Aşamasındaki sonuç/response HTML yanıtı yerine JSON formatında yanıt alırsınız.
- Aşama D’nin sonunda, Payfull üye işyeri eşleştirmesi ve güvenlik için Hash kullanarak dönüş sağlayacaktır.
merchant: ZORUNLUPayfull 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_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
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.
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.
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
use3d: ZORUNLU
Bu parametre 1 olmalıdır aksi halde normal bir satış işleminden farksız çalışır.
3D sayfasından dönecek olan sonuç verilerinin gönderileceği link adresini buraya giriniz.
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.
(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.
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;
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.
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:
ZORUNLUEmail hesabı
customer_phone:
ZORUNLUTelefon 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.
Güvenlik kodu (hash) değerini oluşturmak için aşağıdaki işlemler sırası ile gerçekleştirilmelidir;
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.
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.
Güvenlik kodu (hash) değerini oluşturmak için aşağıdaki işlemler sırası ile gerçekleştirilmelidir;
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.
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.
Güvenlik kodu (hash) değerini oluşturmak için aşağıdaki işlemler sırası ile gerçekleştirilmelidir;
Önprovizyon olarak başlatılan bir işlemin daha sonra satışa çevrilmesidir. Satışa çevrilen tutar kart hamilinin ekstresine yansıyacaktır. Önprovizyonu satışa çevirme işlemi tamamlandığında, gün sonu işleminden sonra işyeri hesabına ilgili tutar aktarılacaktır.
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 Capture 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: ZORUNLU
Payfull tarafından üretilip Satış işlemi sonrası cevap bilgisinde geri gönderilir.
total: ZORUNLU
Ödemenin miktarında kuruş değeride belirtilmelidir. Örnek olarak: 10.23 yada 10.00
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;
- 3D Secure güvenlik satış İşleminde, normal satıştan farklı olarak use3d ve return_url olmak üzere iki ekstra parametre bulunur.
- Ayrıca lütfen TOKEN ve taksitlerin kullanılacağını öğrenmek/görmek için Satış İşlemi sayfasını kontrol edin.
- Aşama A:Satış isteği gönderirken use3d ve return_url ile birlikte göndermeniz gerekir.
- Aşama B: bağlantı isteği güvenli bir şekilde kurulursa HTML yanıtı alırsınız.
- Aşama C: : Dönen cevabı tarayıcıya HTML olarak yazdırmanız gerekir; bu sayede 3D doğrulama sayfası tarayıcınızda (OTP girişi yapılacak ekran) görünür ve kart sahibi işleme devam edebilir.
- Aşama D: Kart sahibi 3D şifresini ekrana başarılı olarak girdikten sonra, Payfull response mesajını (JSON formatında) return_url’nize döner.
Önemli notlar
- 3D isteği güvenli bir şekilde kurulmazsa, B Aşamasındaki sonuç/response HTML yanıtı yerine JSON formatında yanıt alırsınız.
- Aşama D’nin sonunda, Payfull üye işyeri eşleştirmesi ve güvenlik için Hash kullanarak dönüş sağlayacaktır.
merchant: ZORUNLUPayfull 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_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
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.
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.
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
use3d: ZORUNLU
Bu parametre 1 olmalıdır aksi halde normal bir satış işleminden farksız çalışır.
3D sayfasından dönecek olan sonuç verilerinin gönderileceği link adresini buraya giriniz.
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.
(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.
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;
Önprovizyon olarak başlatılan bir işlemin daha sonra satışa çevrilmesidir. Satışa çevrilen tutar kart hamilinin ekstresine yansıyacaktır. Önprovizyonu satışa çevirme işlemi tamamlandığında, gün sonu işleminden sonra işyeri hesabına ilgili tutar aktarılacaktır.
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 Capture 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: ZORUNLU
Payfull tarafından üretilip Satış işlemi sonrası cevap bilgisinde geri gönderilir.
total: ZORUNLU
Ödemenin miktarında kuruş değeride belirtilmelidir. Örnek olarak: 10.23 yada 10.00
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;
- 3D Secure güvenlik satış İşleminde, normal satıştan farklı olarak use3d ve return_url olmak üzere iki ekstra parametre bulunur.
- Ayrıca lütfen TOKEN ve taksitlerin kullanılacağını öğrenmek/görmek için Satış İşlemi sayfasını kontrol edin.
- Aşama A:Satış isteği gönderirken use3d ve return_url ile birlikte göndermeniz gerekir.
- Aşama B: bağlantı isteği güvenli bir şekilde kurulursa HTML yanıtı alırsınız.
- Aşama C: : Dönen cevabı tarayıcıya HTML olarak yazdırmanız gerekir; bu sayede 3D doğrulama sayfası tarayıcınızda (OTP girişi yapılacak ekran) görünür ve kart sahibi işleme devam edebilir.
- Aşama D: Kart sahibi 3D şifresini ekrana başarılı olarak girdikten sonra, Payfull response mesajını (JSON formatında) return_url’nize döner.
Önemli notlar
- 3D isteği güvenli bir şekilde kurulmazsa, B Aşamasındaki sonuç/response HTML yanıtı yerine JSON formatında yanıt alırsınız.
- Aşama D’nin sonunda, Payfull üye işyeri eşleştirmesi ve güvenlik için Hash kullanarak dönüş sağlayacaktır.
merchant: ZORUNLUPayfull 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_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
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.
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.
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
use3d: ZORUNLU
Bu parametre 1 olmalıdır aksi halde normal bir satış işleminden farksız çalışır.
3D sayfasından dönecek olan sonuç verilerinin gönderileceği link adresini buraya giriniz.
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.
(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.
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;
Önprovizyon olarak başlatılan bir işlemin daha sonra satışa çevrilmesidir. Satışa çevrilen tutar kart hamilinin ekstresine yansıyacaktır. Önprovizyonu satışa çevirme işlemi tamamlandığında, gün sonu işleminden sonra işyeri hesabına ilgili tutar aktarılacaktır.
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 Capture 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: ZORUNLU
Payfull tarafından üretilip Satış işlemi sonrası cevap bilgisinde geri gönderilir.
total: ZORUNLU
Ödemenin miktarında kuruş değeride belirtilmelidir. Örnek olarak: 10.23 yada 10.00
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;
- 3D Secure güvenlik satış İşleminde, normal satıştan farklı olarak use3d ve return_url olmak üzere iki ekstra parametre bulunur.
- Ayrıca lütfen TOKEN ve taksitlerin kullanılacağını öğrenmek/görmek için Satış İşlemi sayfasını kontrol edin.
- Aşama A:Satış isteği gönderirken use3d ve return_url ile birlikte göndermeniz gerekir.
- Aşama B: bağlantı isteği güvenli bir şekilde kurulursa HTML yanıtı alırsınız.
- Aşama C: : Dönen cevabı tarayıcıya HTML olarak yazdırmanız gerekir; bu sayede 3D doğrulama sayfası tarayıcınızda (OTP girişi yapılacak ekran) görünür ve kart sahibi işleme devam edebilir.
- Aşama D: Kart sahibi 3D şifresini ekrana başarılı olarak girdikten sonra, Payfull response mesajını (JSON formatında) return_url’nize döner.
Önemli notlar
- 3D isteği güvenli bir şekilde kurulmazsa, B Aşamasındaki sonuç/response HTML yanıtı yerine JSON formatında yanıt alırsınız.
- Aşama D’nin sonunda, Payfull üye işyeri eşleştirmesi ve güvenlik için Hash kullanarak dönüş sağlayacaktır.
merchant: ZORUNLUPayfull 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_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
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.
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.
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
use3d: ZORUNLU
Bu parametre 1 olmalıdır aksi halde normal bir satış işleminden farksız çalışır.
3D sayfasından dönecek olan sonuç verilerinin gönderileceği link adresini buraya giriniz.
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.
(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.
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;
Önprovizyon olarak başlatılan bir işlemin daha sonra satışa çevrilmesidir. Satışa çevrilen tutar kart hamilinin ekstresine yansıyacaktır. Önprovizyonu satışa çevirme işlemi tamamlandığında, gün sonu işleminden sonra işyeri hesabına ilgili tutar aktarılacaktır.
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 Capture 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: ZORUNLU
Payfull tarafından üretilip Satış işlemi sonrası cevap bilgisinde geri gönderilir.
total: ZORUNLU
Ödemenin miktarında kuruş değeride belirtilmelidir. Örnek olarak: 10.23 yada 10.00
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;
Önprovizyon olarak başlatılan bir işlemin daha sonra satışa çevrilmesidir. Satışa çevrilen tutar kart hamilinin ekstresine yansıyacaktır. Önprovizyonu satışa çevirme işlemi tamamlandığında, gün sonu işleminden sonra işyeri hesabına ilgili tutar aktarılacaktır.
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 Capture 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: ZORUNLU
Payfull tarafından üretilip Satış işlemi sonrası cevap bilgisinde geri gönderilir.
total: ZORUNLU
Ödemenin miktarında kuruş değeride belirtilmelidir. Örnek olarak: 10.23 yada 10.00
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;
Önprovizyon olarak başlatılan bir işlemin daha sonra satışa çevrilmesidir. Satışa çevrilen tutar kart hamilinin ekstresine yansıyacaktır. Önprovizyonu satışa çevirme işlemi tamamlandığında, gün sonu işleminden sonra işyeri hesabına ilgili tutar aktarılacaktır.
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 Capture 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: ZORUNLU
Payfull tarafından üretilip Satış işlemi sonrası cevap bilgisinde geri gönderilir.
total: ZORUNLU
Ödemenin miktarında kuruş değeride belirtilmelidir. Örnek olarak: 10.23 yada 10.00
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;
Önprovizyon olarak başlatılan bir işlemin daha sonra satışa çevrilmesidir. Satışa çevrilen tutar kart hamilinin ekstresine yansıyacaktır. Önprovizyonu satışa çevirme işlemi tamamlandığında, gün sonu işleminden sonra işyeri hesabına ilgili tutar aktarılacaktır.
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 Capture 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: ZORUNLU
Payfull tarafından üretilip Satış işlemi sonrası cevap bilgisinde geri gönderilir.
total: ZORUNLU
Ödemenin miktarında kuruş değeride belirtilmelidir. Örnek olarak: 10.23 yada 10.00
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;