WAARSCHUWING: Nieuw aangemaakte donatieformulieren worden opgeslagen als V2. Raadpleeg de helptekst met betrekking tot V2. De donatieformulieren in dit document behoren tot een oudere versie!
Wat is een donatieformulier?
Donatieformulieren zijn een infrastructuur waarmee u donaties kunt ontvangen door ze te integreren in uw eigen website. U kunt een donatieformulier aanmaken door naar het menu aan de linkerkant te gaan: Donaties > Donatieformulier.
Waar moet ik op letten?
Het belangrijkste punt bij het aanmaken van een donatieformulier is het invoeren van het adres van de website waar u het formulier zult gebruiken. U moet https:// opnemen aan het begin van het adres. En als uw website meerdere versies heeft, moet u deze uniek maken. Donatieformulieren werken alleen met HTTPS.
Bijvoorbeeld;
Als uw site werkt als zowel https://www.adimadim.org als https://adimadim.org, kies dan slechts één en verwijs de niet-gekozen domeinnaam door naar de andere.
Website-integratie
WAARSCHUWING! Deze integratie vereist softwarekennis. U moet bedreven zijn in basis HTML en Javascript. Als u niet bedreven bent in deze onderwerpen, gebruik dan onze standaard donatiepagina's.
Eerst kunt u de benodigde API-sleutel (api_key) en Campagnecode (campaign) voor het gebruik van het formulier op uw pagina verkrijgen via de sectie Acties > Integratie-informatie in de donatieformulierenlijst.
Vlak voor het </head> gedeelte van uw webpagina
<meta name="Referrer" content="origin"><script type="text/javascript" src="https://s.fonzip.com/js/fonzip.loader.js"></script>
Voeg ons script op deze manier toe aan de pagina.
Nadat u de secties op uw webpagina hebt voorbereid waar u de parameters voor het bedrag en de terugkerende donatie zult ontvangen, moet u de functie fz.bagis aanroepen wanneer op de donatieknop wordt geklikt.
Parameters
api_key: Uw API-sleutel (Verplicht)
amount: Donatiebedrag (Verplicht)
currency: ISO-code van de valuta, standaard de valuta van de organisatie,
recurring: Is het een terugkerende donatie? (Verplicht)
campaign: Uw campagnecode (Verplicht)
lang: Leeg of "tr" voor Turks, "en" voor Engels, standaard de browsertaal
get_news: Toestemming voor communicatie, true indien gegeven, false indien niet
referring: Indien gewenst dat donatie namens iemand anders is geselecteerd, true, anders false
cardholder_name: Indien gewenst dat de naam en achternaam van de donateur zijn ingevuld, moet dit worden ingevuld
email: Indien gewenst dat het e-mailadres is ingevuld, moet dit worden ingevuld
ref_to: Indien gewenst dat de naam van de persoon namens wie de donatie wordt gedaan is ingevuld, moet dit worden ingevuld
ref_email: Indien gewenst dat het e-mailadres van de persoon namens wie de donatie wordt gedaan is ingevuld, moet dit worden ingevuld
tckno: Indien gewenst dat het TCKN is ingevuld, moet dit worden ingevuld, moet 11 cijfers bevatten
phone: Indien gewenst dat het telefoonnummer is ingevuld, moet dit worden ingevuld, mag alleen cijfers bevatten
birthday: Geboortedatum, moet in GG/AA/JJJJ-formaat zijn en moet worden ingevuld indien gewenst
details: Beschrijvingsveld, moet worden ingevuld indien gewenst
api_tracking_id: Vereiste code om het geopende formulier te kunnen volgen
fundraising_campaign_id: Moet worden verzonden indien het geopende formulier moet worden gekoppeld aan een gebruikerscampagne
name_hidden: Moet de naam verborgen worden bij een donatie aan een gebruikerscampagne?
amount_visible: Moet het donatiebedrag zichtbaar zijn bij een donatie aan een gebruikerscampagne?
custom_parameters: Uw aangepaste parameters
onload: Acties die u wilt uitvoeren op uw pagina wanneer het donatieformulier wordt geopend
success: Acties die u wilt uitvoeren op uw pagina wanneer de donatie is voltooid, retourneert succesvolle donatiegegevens
error: Acties die u wilt uitvoeren op uw pagina wanneer de donatie mislukt
close: Acties die u wilt uitvoeren op uw pagina wanneer het formulier wordt gesloten, als het wordt gesloten na een succesvolle donatie, retourneert de resultaatparameter true.
fz.bagis({ api_key: "UW API SLEUTEL", amount: "Bedrag", currency: "TRY", recurring: false || true, campaign: "UW CAMPAGNECODE", lang:"nl", get_news: true, referring: false, cardholder_name: "Naam en achternaam donateur", email: "E-mailadres", ref_to: "Naam van de persoon namens wie gedoneerd wordt", ref_email: "E-mailadres van de persoon namens wie gedoneerd wordt", tckno: "TCKN", phone: "Telefoonnummer", birthday: "GG/AA/YYYY", details: "Omschrijving", api_tracking_id: "Tracking Code", fundraising_campaign_id: "Gebruikerscampagne ID", name_hidden: false || true, amount_visible: false || true, custom_parameters: { //uw aangepaste parameters }, onload: function() { //HANDELINGEN DIE U MOET UITVOEREN WANNEER HET LADEN IS VOLTOOID }, success: function(data) { var donateur_naam = data.name; var donatie_bedrag = data.amount; var donateur_email = data.email; var campagne = data.campaign_id; var adres = data.address; var telefoon = data.phone; var tckno = data.tckno; var geboortedatum = data.birthday; var stad = data.city; var district = data.district; var omschrijving = data.details; var tckno = data.tckno; var namens_iemand = data.referring; var naam_persoon_namens_wie_gedoneerd = data.referring_name; var email_persoon_namens_wie_gedoneerd = data.referring_email; var terugkerend = data.recurring; var transactie_nr = data.order_id; var bank_transactie_nr = data.transaction_id; var bank_provisie_nr = data.provision_no; var api_tracking_id = data.api_tracking_id; // HANDELINGEN DIE U MOET UITVOEREN BIJ SUCCES }, error: function(data) { var foutcode = data.error_code; var foutomschrijving = data.error_description; // HANDELINGEN DIE U MOET UITVOEREN BIJ FOUT }, close: function(result) { //true is succesvolle donatie, anders andere statussen //Handelingen die moeten worden uitgevoerd wanneer het formulier wordt gesloten }});Aangepaste Parameters
Om velden die niet zijn gedefinieerd in Fonzip, maar die u gebruikt bij het ontvangen van donaties, naar Fonzip over te dragen, kunt u de functie voor aangepaste parameters gebruiken.
Aangepaste Parameter Aanmaken
U kunt een parameter aanmaken door op de tekst Parameter toevoegen te klikken in het gedeelte Aangepaste Parameters onderaan de pagina voor het aanmaken/bewerken van het donatieformulier.
Op het scherm dat verschijnt, voert u de sleutelwaarde in die u wilt gebruiken voor de parameter in het veld Veldnaam, en de waarde die u in het systeem wilt zien in het veld Omschrijving, en slaat u dit op.
Als voorbeeld hebben we een parameter aangemaakt met de veldnaam bon en de beschrijving Bonverzoek. Als de donateur een bon wil, vullen we dit veld in met "Ja", en als er geen bon gewenst is, met "Nee".
Opmerking: Er zijn geen beperkingen op de waarden die in de parameters kunnen worden doorgegeven.
Bij het verzenden van een donatieverzoek moet u uw parameter in de fz.bagis functie als volgt verzenden:
var bon_waarde = bon_checkbox.selected ? "Ja":"Nee";fz.bagis({ api_key: "UW API SLEUTEL", amount: "bedrag", currency: "TRY", recurring: false, campaign: "UW CAMPAGNECODE", custom_parameters: { bon: bon_waarde }, success: function(data) { // HANDELINGEN DIE U MOET UITVOEREN BIJ SUCCES }, error: function(data) { // HANDELINGEN DIE U MOET UITVOEREN BIJ FOUT }});Nadat de donatie is voltooid, als de optie 'bon gewenst' is geselecteerd, kunt u de relevante gegevens zien in de donatiedetails zoals hieronder.
Waarschuwingen voor aangepaste parameters
Het verzenden van een parameter die niet is gedefinieerd in de formulierinstellingen, zal een fout in het systeem veroorzaken.
Het verzenden van gegevens in een ander formaat dan JSON zal een fout in het systeem veroorzaken.
Wanneer u de veldnaam van een eerder toegevoegde parameter later wijzigt/verwijdert, kunt u de gegevens in de betreffende donaties verliezen.
Voorbeeldcode
U kunt voorbeeld HTML-, CSS- en Javascript-bestanden vinden op https://bitbucket.org/erdifonzip/fonzip-donation-form-integration.