UYARI: Yeni oluşturulan bağış formları V2 olarak kayıtlıdır. Lütfen V2 ile ilgili olan yardım metnini inceleyin. Bu dokümandaki bağış formları eski bir versiyona aittir!
Bağış formu nedir?
Bağış formları, kendi web sitenize entegre ederek bağış almanızı sağlayan bir altyapıdır. Soldaki mende bulunan Bağışlar > Bağış Formu bölümüne girerek bir bağış formu oluşturabilirsiniz.
Nelere dikkat etmeli?
Bağış formu oluştururken dikkat edilmesi gereken en önemli nokta formu kullanacağınız web sitesi adresini girmeniz. Adresi girerken başında https:// i dahil etmelisiniz. Ve web sitenizin birden çok versiyonu varsa onu tekil hale getirmelisiniz. Bağış formları sadece HTTPS ile çalışır.
Örnek olarak;
Eğer siteniz hem https://www.adimadim.org, hem https://adimadim.org olarak çalışıyorsa lütfen sadece birini seçin ve seçmediğiniz alan adını diğerine yönlendirin.
Web sitesi entegrasyonu
UYARI! Bu entegrasyon yazılım bilgisi gerektirir. Temel HTML ve Javascript'e hakim olmanız gerekir. Eğer bu konulara hakim değilseniz lütfen standart bağış sayfalarımızı kullanın.
İlk olarak formu sayfanızda kullanmanız için gerekli olan API anahtarı (api_key) ve Kampanya Kodu (campaign) bağış formu listesindeki İşlemler > Entegrasyon Bilgileri bölümünden alabilirsiniz.
Web sayfanızın </head> kısmından hemen önce
<meta name="Referrer" content="origin"><script type="text/javascript" src="https://s.fonzip.com/js/fonzip.loader.js"></script>
Şeklinde scriptimizi sayfaya ekleyin.
Daha sonra web sayfanızda miktar ve düzenli bağış parametrelerini alacağınız bölümleri hazırladıktan sonra bağış yap butonuna tıklanıldığında fz.bagis fonksiyonunu çağırmalısınız.
Parametreler
api_key: API Anahtarınız (Zorunlu)
amount: Bağış Miktarı (Zorunlu)
currency: Para birimi ISO kodu, varsayılan olarak kurum para birimi,
recurring: Düzenli Bağış mı (Zorunlu)
campaign: Kampanya Kodunuz (Zorunlu)
lang: Türkçe için boş veya "tr", İngilizce için "en", varsayılan olarak tarayıcı dili
get_news: İletişim izni verilmesi, verildiyse true, verilmediyse false
referring: Birisi adına bağış seçili açılsın isteniyorsa true yoksa false
cardholder_name: Bağışçı adı soyadı dolu gelsin isteniyorsa doldurulmalı
email: E-Posta adresi dolu gelsin isteniyorsa doldurulmalı
ref_to: Adına bağış yapılacak kişi adı dolu gelsin isteniyorsa doldurulmalı
ref_email: Adına bağış yapılacak kişinin e-postası dolu gelsin isteniyorsa doldurulmalı
tckno: TCKN dolu gelsin isteniyorsa doldurulmalı, 11 hane olmalı
phone: Telefon dolu gelsin isteniyorsa doldurulmalı, sadece sayı olmalı
birthday: Doğum tarihi, GG/AA/YYYY formatında olmalı ve dolu gelsin isteniyorsa doldurulmalı
details: Açıklama alanı, dolu gelsin isteniyorsa doldurulmalı
api_tracking_id: Açılan formun takip edilebilmesi için gerekli kod
fundraising_campaign_id: Açılan formun bir kullanıcı kampanyasına bağlanması isteniyorsa gönderilmeli
name_hidden: Kullanıcı kampanyasına yapılan bağışta isim gizlensin mi?
amount_visible: Kullanıcı kampanyasına yapılan bağışta bağış miktarı gözüksün mü?
custom_parameters: Özel parametreleriniz
onload: Bağış formu açıldığında sayfanızda yapılmasını istediğiniz işlemler
success: Bağış tamamlandığında sayfanızda yapılmasını istediğiniz işlemler, başarılı bağış bilgilerini döner
error: Bağış başarısız olduğunda sayfanızda yapılmasını istediğiniz işlemler
close: Form kapatıldığında sayfanızda yapılmasını istediğiniz işlemler, eğer başarılı bağış sonrası kapanıyorsa result parametresi true döner.
fz.bagis({ api_key: "API ANAHTARINIZ", amount: "Miktar", currency: "TRY", recurring: false || true, campaign: "KAMPANYA KODUNUZ", lang:"tr", // get_news: true, referring: false, cardholder_name: "Bağışçı adı soyadı", email: "E-Posta adresi", ref_to: "Adına bağış yapılacak kişi adı", ref_email: "Adına bağış yapılacak kişinin e-postası", tckno: "TCKN", phone: "Telefon", birthday: "GG/AA/YYYY", details: "Açıklama", api_tracking_id: "Takip Kodu", fundraising_campaign_id: "Kullanıcı kampanya id", name_hidden: false || true, amount_visible: false || true, custom_parameters: { //özel parametreleriniz }, onload: function() { //YÜKLEME TAMAMLANDIĞINDA YAPACAĞINIZ İŞLEMLER }, success: function(data) { var bagisci_adi = data.name; var bagis_miktari = data.amount; var bagisci_eposta = data.email; var kampanya = data.campaign_id; var adres = data.address; var telefon = data.phone; var tckno = data.tckno; var dogum_tarihi = data.birthday; var il = data.city; var ilce = data.district; var aciklama = data.details; var tckno = data.tckno; var birisi_adina = data.referring; var adina_bagis_yapilan_kisi = data.referring_name; var adina_bagis_yapilan_kisinin_epostasi = data.referring_email; var duzenli = data.recurring; var islem_no = data.order_id; var banka_islem_no = data.transaction_id; var banka_provizyon_no = data.provision_no; var api_tracking_id = data.api_tracking_id; // BAŞARILI OLDUĞUNDA YAPACAĞINIZ İŞLEMLER }, error: function(data) { var hata_kodu = data.error_code; var hata_aciklamasi = data.error_description; // BAŞARISIZ OLDUĞUNDA YAPACAĞINIZ İŞLEMLER }, close: function(result) { //true ise başarılı bağış, değil ise diğer durumlar //Form kapandığında yapılacak işlemler }});Özel Parametreler
Fonzip'te tanımlı bulunmayan, fakat sizin bağış alırken kullandığınız herhangi bir alanı Fonzip'e aktarmak için özel parametreler özelliğini kullanabilirsiniz.
Özel Parametre Oluşturma
Bağış formunu oluşturma/düzenleme sayfasını en altında bulunan Özel Parametreler bölümünden Parametre ekle yazısına tıklayarak parametre oluşturabilirsiniz.
Karşınıza çıkan ekranda Alan adı bölümüne parametrede geçeceğiniz anahtar değerini, Açıklama bölümüne ise sistemde gözükmesini istediğiniz değeri yazın ve kaydedin.
Örnek olarak alan adı makbuz, açıklaması da Makbuz İsteği alanı adında bir parametre oluşturduk. Eğer bağış yapan kişi ek olarak makbuz istiyorsa bu alanı "Var", eğer makbuz istemiyorsa "Yok" şeklinde dolduracağız.
Not: Parametrelerde geçilecek değerlerde herhangi bir kısıtlama bulunmamaktadır.
Bağış isteği gönderirken fz.bagis fonksiyonunda parametrenizi aşağıdaki gibi göndermeniz gerekmektedir
var makbuz_degeri = makbuz_checkbox.selected ? "Var":"Yok";fz.bagis({ api_key: "API ANAHTARINIZ", amount: "miktar", currency: "TRY", recurring: false, campaign: "KAMPANYA KODUNUZ", custom_parameters: { makbuz: makbuz_degeri }, success: function(data) { // BAŞARILI OLDUĞUNDA YAPACAĞINIZ İŞLEMLER }, error: function(data) { // BAŞARISIZ OLDUĞUNDA YAPACAĞINIZ İŞLEMLER }});Bağış tamamlandıktan sonra eğer makbuz isteniyor seçeneği seçildiyse bağış detaylarında aşağıdaki gibi ilgili veriyi görebilirsiniz.
Özel Parametre Uyarıları
Form ayarlarında tanımlanmayan bir parametre gönderilmesi sistemde hata verilmesine sebep olacaktır.
JSON formatı dışında veri gönderilmesi sistemde hata verilmesine sebep olacaktır.
Önceden eklediğiniz bir parametrenin alan adını daha sonradan değiştirdiğinizde/sildiğinizde ilgili bağışlardaki veriyi kaybedebilirsiniz.
Örnek Kod
https://bitbucket.org/erdifonzip/fonzip-donation-form-integration adresinden örnek HTML, CSS ve Javascript dosyalarına ulaşabilirsiniz.