How to use the PayPal button? I need to create a simple donation form.

1. Create your form as you would normally. For the purpose of this example, let's call it PayPal Donation Form and give it a NAME of PayPalDonationForm.

2. Now create a new element with the following properties. (Any fields not mentioned can be left blank.) 

TYPE: Textfield 

LABEL: Donation Amount (or whatever you want to call it) 

NAME: donationAmount (Note: if you change this, it will affect other instructions below)

VALIDATION: Check the 'Required' checkbox 


ERROR MESSAGE: Please enter your donation amount. (or whatever you want to say) 

SCRIPT: FF: :ff_valuenotempty  



3. Create another new element with the following properties. (Any fields not mentioned can be left blank.) 

TYPE: Hidden input 

LABEL: PayPal Select 

NAME: bfPaymentSelect (This MUST be named exactly as shown.)

VALUE: 0.00 





4. Create yet another new element with the following properties. (Any fields not mentioned can be left blank.)

TYPE: PayPal button 

LABEL: Submit Donation (or whatever you want on the button) 

NAME: PayPalButton (or whatever you want to call it) 

BUSINESS: Enter the PRIMARY email address associated with your PayPal account. 

TOKEN: Enter the PayPal token you generated while logged into your account on PayPal. For instructions on how to do that, please see:

ITEM NAME: Donation 

ITEM NUMBER: Enter whatever you want, or nothing 



THANKYOU PAGE: If you want to send them back to the form's thank you page after the transaction is complete, enter the following URL in this field: 

Replace with your own website address, and replace paypal_donation_form with the NAME that you assigned to the form on the form properties screen. (In QuickMode, it should be the second field in the form properties screen.) 

 If you want to direct a user to a different URL, just enter your thank you page URL in the field. 

LOCALE: us (Refer to PayPal's user guide for correct locale -- this example is for a US account)  

CURRENCY CODE: USD (Refer to PayPal's user guide for correct currency code -- this example is for a US account)

EMAIL NOTIFICATION ON SUCCESSFUL PAYMENT ONLY: Usually checked, but you may prefer notifications on all attempts. If so, uncheck the box. 



5. Now go to the PayPal Button's ADVANCED tab and enter the following values. (Any fields not mentioned can be left blank.)   

HIDE LABEL: Optional -- some people like it, some don't. 

IMAGE: A default image URL is entered. If you'd like to change it, please go to your PayPal account to see other button images available and then replace the URL with the one that corresponds with the image you prefer. 

TEST ACCOUNT: You can create a test account on PayPal to try and work out any kinks in the form before processing an actual transaction. Please refer to PayPal for instructions on how to do this.

TEST BUSINESS: Enter the test business Email address generated when you created your PayPal Sandbox / Test account. 

TEST TOKEN: Enter the test token generated when you create your PayPal Sandbox / Test account. 

DOWNLOADABLE FILE: Place a checkmark in the box if it is a downloadable file. 

FILEPATH: Enter the full filepath to your downloadable file. For example: /public_html/JoomlaRoot/path/to/filename/ 

DOWNLOAD TRIES: Enter the number of times a user may attempt to download the file. 


 6. Now you need to create an Actionscript to actually get the data to submit to PayPal. For it, use the following settings:

 TYPE: Custom 

ACTIONS: Click (this should be CHECKED) 


Now click on the CREATE CODE FRAMEWORK text that is placed right above the text area. Highlight all of the text between the first curly bracket { and the last one } (but not the curly brackets themselves) and then click on your delete button to remove the text. After doing that, your actionscript should look something like this: 


function ff_PayPalButton_action(element, action) 

} // ff_PayPalButton_action 


Now add the following text between those curly brackets:


switch (action)
     case 'click':  ff_getElementByName('bfPaymentSelect').value = 'Donation|0|' + ff_getElementByName('donationAmount').value + '|0';
} // switch


 So the entire code within that text area should now look something like this: 


function ff_PayPalButton_action(element, action) 
     switch (action)
          case 'click': 
          ff_getElementByName('bfPaymentSelect').value = 'Donation|0|' + ff_getElementByName('donationAmount').value + '|0'; 
     } // switch 
} // ff_PayPalButton_action 




7. Last but not least, click on the SAVE button in the upper right-hand corner of the screen. You should now be ready to put the form on your site and test it out.



In case that you are using html5 upload file you should do following:

Instead ff_validate_submit script usage check ACTION CLICK and paste code bellow:

ff_elementName_action(element, action)
    switch (action) {
        case 'click':
    } // switch
} // ff_elementName_action


Watch our for element name. Make sure that you rename 'elementName' with your element name.



Special Offer

Sale! All subscriptions at a special price!

Includes prio support, all of our current and future Joomla!® extensions and Joomla!® templates for the duration of your membership.

Get it from here

3rd Party Discount - 25% Off

We help you to keep your costs under control. If you are a new member and purchased a form building tool from a different form vendor, then you'll get a 25% discount on our subscription plans.

How to receive the discount:

Send us a quick email to with a proof of purchase (for example a paypal receipt), await payment instructions and enjoy your membership!

Live Support Chat Opened!

Join our Discord chat here and enter the Crosstec channels to receive live support and talk directly to the team!