Contribution Payments – Donate Buttons

Use Donate buttons to collect contribution payments. Donate buttons let you collect pre-determined amounts or amounts entered by donors.

You can create Donate buttons that you add to your website by using a tool on the PayPal website, or you can write the HTML code for PayPal hosted Donate buttons manually. You can create buttons with limited functionality before you create your PayPal account or with JavaScript disabled in your browser.

Read the following topics to learn more about Donate buttons:

Getting Started With Donate Buttons

The easiest way to add a Donate button to your website is by using the button creation tool on the PayPal website. As soon as you add the button, you can begin accepting contribution payments on your website.

Follow one of these procedures to get started creating your own Donate buttons:

Using the Button Creation Tool for a Basic Donate Button

To use the button creation tool for a basic Donate button:

  1. Log in to your PayPal Premier or Business account at https://www.paypal.com.
    The My Account Overview page opens.
  2. Click the Profile subtab.
    The Profile Summary page opens.
  3. Under the Selling Preferences heading, click the My Saved Buttons link.
    The My Saved Buttons page opens.
  4. In the Related Items box on the right, click the Create new button link.
    The Create PayPal payment button page opens.
  5. In the Accept payments for dropdown menu, select "Donations".
  6. (Optional) In the Organization name/service text box, enter the purpose for the donation or the name of your organization. If you do not enter anything in this field, your donors can complete this field during checkout.
  7. Scroll to the bottom of the page, and click the Create Button button.
    The You are viewing your button code page opens.
  8. Click the Select Code button on the Websites tab to select all of the generated HTML code.
  9. Copy the text that you selected to the clipboard, by:
    • Pressing Ctrl+C.
      – or –
    • Right-clicking your mouse, and selecting Copy.
  10. In your web editing tool, open the webpage where you want the button.
    Important: Be sure that your tool is ready for you to paste HTML code, such as by switching to an HTML view from a design view of your webpage.
  11. Paste the text that you copied from the clipboard onto your webpage where you want the button to appear, by:
    • Pressing Ctrl+V.
      – or –
    • Right-clicking your mouse, and selecting Paste.

Creating Donate Buttons Before You Create Your PayPal Account

You can create basic Donate buttons, add them to your website, and begin accepting contributions before you sign up for your PayPal account. Read the following topics to learn more about creating Donate buttons before you create your PayPal account.

Creating a Basic Donate Button Without a PayPal Account

Note: You cannot create payment buttons without a PayPal account if JavaScript is disabled in your browser.
  1. Click the Business tab.
  2. Click Accept Credit Cards on a Website.
  3. Under the PayPal Payments Standard heading, click the Select button.

    A page that describes PayPal Payments Standard opens.

  4. Click the Try it now button.

    The Create PayPal payment button page opens.

  5. In the Accept payments for dropdown menu, select "Donations."
  6. Enter the payment details for your Donate button.
    • Organization name/service – Enter the purpose for the donation or the name of your organization. If you do not enter anything in this field, your donors can complete this field during checkout.
    • Email address to receive payments– Enter the email address that you will use when you sign up for your PayPal account.
  7. Scroll to the bottom of the page, and click the Create Button button.

    The You've created your button page opens.

  8. Click the Select Code button on the Websites tab to select all of the generated HTML code.
  9. Do one of the following to copy the selected text to the clipboard:
    • For Windows and Mac, right-click on the code, and then select Copy.
    • For Windows, press Ctrl+C.
    • For Mac, press CMD+C.
  10. In your web editing tool, open the webpage where you want to show the button.
    Important: Be sure that your tool is ready for you to paste HTML code, such as by switching to an HTML view from a design view of your webpage.
  11. Do one of the following to paste the text from the clipboard onto your webpage, where you want the button to appear:
    • For Windows or Mac, right-click on the code, and then select Paste.
    • For Windows, press Ctrl+V.
    • For Mac, press CMD+V.

Sign up for your PayPal account. You cannot collect payments that buyers make with your payment button until you sign up successfully for your PayPal Premier account or Business account.

Limitations of Donate Buttons Created Without a PayPal Account

Consider the following limitations of payment buttons that you create and add to your website before you sign up for your PayPal account.

  • You cannot claim the payments that people authorize during checkout. PayPal collects and holds the payments as unclaimed until you sign up for your PayPal account.
  • Donors must have a PayPal account to pay you. Any ability to pay by credit card is disabled.
  • PayPal limits the features that you can specify with the button creation tool, such as saving your buttons in your PayPal account.
Note: You cannot create payment buttons without a PayPal account if JavaScript is disabled in your browser.

Unclaimed Payments From Buttons Created Without a PayPal Account

For buttons that you create without a PayPal account, payments that donors authorize are held as unclaimed by PayPal until you sign up. PayPal holds your unclaimed payments under the email address that you specify when you create the buttons. Make sure to use the same email address when you sign up for your account. Otherwise PayPal cannot transfer your unclaimed payments to your PayPal account balance.

In their PayPal accounts, donors see unclaimed payments that they made to you from Donate buttons that you created without a PayPal account. Such unclaimed payments are displayed in their recent account activity and in their transaction history. Until you finish signing up for your PayPal account, donors can cancel your unclaimed payments and recover their funds.

Figure 1. Unclaimed Payments From Buttons Created Without a PayPal Account

The Checkout Experience With Donate Buttons

This section demonstrates the PayPal checkout experience for people who click Donate buttons on your website. The following diagram illustrates the steps.

Figure 2. The Checkout Experience with Donate Buttons

Read these topics to better understand the checkout experience with Donate buttons:

Begin – Donors are Ready to Contribute on Your Website

The basic checkout experience with Donate buttons begins when someone on your website is ready to contribute.

Figure 3. Donors Begin on Your Website When They Are Ready to Contribute

In this example, Mary begins on the website of her favorite cause and wants to contribute to the Fall Cleanup Campaign. Mary clicks the Donate button to check out.

1 – Donors Enter Their Billing Information or They Log In to PayPal

PayPal displays a billing information/log-in page, which lets donors enter their credit card information or log in to PayPal to pay.

Figure 4. Donors Enter Their Billing information or Log In to PayPal

For Donate buttons, the PayPal billing information/log-in page shows transaction details near the top, such as the name of the contribution and the contribution total.

If donors are satisfied with the details, they do one of the following to select a payment method:

  • To pay with a credit card – Donors enter their billing information. They also enter their contact information – email address and home phone number– so that PayPal can send them their PayPal transaction receipts and can contact them if necessary to complete the transaction. Then, they click the Review Order and Continue button.
  • To pay with a PayPal account – Donors enter their PayPal credentials and click the Log in button.

In this case, Mary is satisfied with her contribution to Friends of the Park in the amount of $25.00 USD. She enters her billing and contact information, and then she clicks the Review Order and Continue button.

2 – Donors Confirm Their Contribution Details Before Paying

PayPal displays a transaction confirmation page to let donors confirm the details before they complete their transactions and authorize their payments.

Figure 5. Donors Confirm Their Contribution Details Before Paying

In this case, Mary reviews the transaction details clicks the Pay Now button to complete the transaction and make her payment.

3 – Donors View and Print Their PayPal Contribution Confirmations

PayPal displays a payment confirmation page after donors pay to let them know that they have made their contributions successfully.

Figure 6. Donors View Their Donation Confirmations

From the payment confirmation page, donors can:

  • View the PayPal Confirmation number – the transaction ID – to reconcile their payments.
  • Click the View Printable Receipt link to print receipts for their records.
    Figure 7. Donors Print Their PayPal Contribution Receipts

    In this case, Mary prints the PayPal contribution receipt for her records.

End – Donors Receive Contribution Authorization Notices by Email

PayPal sends donors a contribution authorization notice by email to confirm the transaction that they made with the contribution coordinator.

In this case, PayPal sends Mary an email message notifying her of her transaction with Friends of the Park and her authorization for payment of $25.00 USD.

Enhancing the Checkout Experience With Donate Buttons

Co-Branding the Checkout Pages with Your Logo and Colors

The basic checkout experience displays your email address or your business name in the upper left corner of the checkout pages. You can enhance the checkout experience by setting up custom page payments in your account profile to specify logos and colors that match the style of your website. PayPal uses the logo and colors to display the checkout pages. In addition, you can specify logos and colors with advanced HTML variables that you add to the code of your button.

For more information, see:

Pre-populating the Checkout Pages With Billing Addresses

The basic checkout experience has forms for filling in billing addresses. You can enhance the checkout experience by pre-populating the forms with donor information from your website.

To learn more about pre-population, see Filling Out FORMs Automatically with HTML Variables.

To learn more about the HTML variables to use, see HTML Variables for Filling Out PayPal Checkout Pages Automatically

Returning Donors to Your Website After They Check Out

The basic checkout experience leaves donors on the PayPal website after they check out. Use one of the following techniques to enhance the checkout experience so that donors return to your website instead of the PayPal website.

  • Return URL – Let donors return to a page on your website if they click a return link or button on the PayPal payment confirmation page.
    To learn more, see Step 2 of Page 2 – Specifying Advanced Features of Your Donate Button or HTML Variables for Displaying PayPal Checkout Pages.
  • Auto Return – Have PayPal return donors automatically to a page on your website.
    Important: PayPal recommends that you turn Payment Data Transfer on when you turn Auto Return on. With Auto Return on, PayPal redirects donors to your website from an alternative PayPal payment confirmation page, which does not allow them to print PayPal receipts. Payment Data Transfer provides the transaction information that you need to let donors print receipts from your website.

    To learn more, see Auto Return.

  • Payment Data Transfer – PayPal includes information about the completed transaction when you use a return URL or Auto Return to send people back to your website. Use the information that Payment Data Transfer provides to display a "thank you, print your receipt" page on your website.

    To learn more, see the Payment Data Transfer webpage on PayPal Developer Network..

Managing Contributions

Using Email Notices to Track Donate Transactions

PayPal sends you email notices when:

  • Payments are made.
  • Payments are pending.
  • Payments are canceled.

Generally, PayPal sends email notices to the primary email address of your account.

PayPal can send email notices to an alternate email address, such as to someone in your organization who handles accounting. Add the additional email address to your account profile. Then, use that email address as the one to receive payments when you use the button creation tool on the PayPal website. Specify the alternate email address as the value for the business HTML variable when you write the HTML code yourself.

For more information, see Step 5 in the instructions for Page 2 – Specifying Advanced Features of Your Donate Button, or HTML Variables for PayPal Payments Standard."

Using Recent Activity to Track Donate Transactions

PayPal displays Donate transactions in your recent activity, soon after donors complete their transactions by clicking Donate buttons on your website.

Figure 8. Using Recent Activity to Track Donate Transactions

To view your recent history:

  1. Log in to you PayPal account.
  2. Navigate to My Account > Overview.
    The My Account Overview opens.
  3. Scroll down to the Recent Activity table near the bottom of the page.

Using Transaction History to Track Donate Transactions

PayPal lets you search for Donate transactions on the History page. The status of payments found there can be:

  • Completed – Transactions were successful, and funds were credited to your account.
  • Cleared – Payments cleared senders' accounts, and funds were credited to your account.
  • Uncleared – Payments have not cleared sender's accounts, and funds were not credited.

To learn how to work with transaction history, see the Merchant Setup and Administration Guide.

Using Downloadable History Logs to Track Donate Transactions

PayPal lets you download your Donate transactions to your computer from the History page. You can specify a date range for the transactions and the file format of the download file.

To learn how to work with downloadable history logs, see the Merchant Setup and Administration Guide.

Using Instant Payment Notification to Track Donate Transactions

PayPal lets your web server receive messages about Donate transactions and payment activity on your account. If you activate Instant Payment Notification, PayPal sends messages when:

  • Payments are first made, with a status of completed or pending.
  • Payments clear, fail, or are denied, if the initial status was pending.

To learn more about Instant Payment Notification, see Instant Payment Notification – notify_url and the Instant Payment Notification Guide.

Creating Advanced Donate Buttons on the PayPal Website

The Basic Steps for Using the Tool With Donate Buttons

The button creation tool for Donate buttons is a single webpage with three sections:

  • Step 1 – Choose button type and enter payment details – This section lets you specify the details of your Donate button. You can specify whether donors enter their own contribution amount or a fixed amount.
  • Step 2 – Save your buttons (optional) – This section lets you control whether to save your button in your PayPal account.
  • Step 3 – Customize advanced features (optional) – This section lets you work with advanced features of Donate buttons. If you are familiar with HTML programming and the advanced HTML variables supported by PayPal Payments Standard buttons, you can enter them here.

One section at a time is open for you to work with. To work with another section, click its step bar to expand it.

You can switch between the sections as often as you like, until you click the Create Button button at the bottom of the page. Then, PayPal generates the code for your button and displays it on the You are viewing your button code page. Copy the code and paste it onto your webpage, and your payment button is complete.

Saving Donate Buttons in Your PayPal Account

By default, the button creation tool saves payment buttons in your PayPal account. The tool saves your button and generates the code when you click the Create Button. You must copy and paste the generated code onto your webpages, whether or not you save your button at PayPal. The generated code is shorter for saved buttons, because PayPal keeps most of the information about your button in your account, instead of placing it in the code that you add to your website.

Saving your payment buttons in your PayPal account has these benefits:

  • Your payment buttons are more secure, because the generated code that you add to your website contains no information that can be tampered with to produce fraudulent payments.
  • You can edit the details and options for your payment buttons in your PayPal account, without changing the button code that you added to your website.

Use the Step 2 section of the button creation tool to control whether your button is saved in your PayPal account. You can have a maximum of 1,000 saved buttons in your PayPal account.

Adding Advanced Features to Donate Buttons With HTML Variables

Some advanced features of payment buttons can be specified only with HTML variables. If you are familiar with HTML programming and the advanced HTML variables supported by PayPal Payments Standard payment buttons, you can enter them in the button creation tool before generating the button code.

Use the Step 3 section of the button creation tool to enter advanced HTML variables that you want to include in your payment button.

For more information, see Step 5 of Step 3 – Adding Advanced Features to Your Donate Button.

Generating Code for Payment Buttons and Email Payment Links

When you create Donate buttons with tools on the PayPal website, PayPal generates HTML code for website payment buttons. Then, you copy and paste the HTML code onto the pages of your website.

In addition to HTML code, PayPal generates URL code for email payment links. Use email payment links to add Donate functionality to your email messages. If your web editing tool or your service provider does not allow you to paste HTML code onto your webpages, you might be able to paste the URL code for email payment links onto your webpages instead.

Protecting HTML Code for Payment Buttons

When you create Donate code with tools on the PayPal website, PayPal lets you protect the HTML button code that it generates by encrypting part of it. Protecting the HTML code of your payment buttons helps protect against malicious tampering and fraudulent payments.

Important: Merchants with significant payment volume are required to take precautions on securing PayPal Payments Standard buttons.

For more information, see Securing Your PayPal Payments Standard Buttons.

Step 1 – Specifying Basic Features of Your Donate Button

To begin using the button creation tool for Donate buttons:

  1. Log in to your PayPal Premier or Business account at https://www.paypal.com.
    The My Account Overview page opens.
  2. Click the Profile subtab.
    The Profile Summary page opens.
  3. Under the Selling Preferences heading, do one of the following:
    • Click the My Saved Buttons link, and then click the Create new button link in the upper right of the page, if you previously saved payment buttons in your PayPal account.
      To create a new button that is similar to a button that you saved, find the saved button in the list. Then, click the Action dropdown menu at the right and click the Create similar button link.
    • Click the Create New Button link, if you have no buttons saved in your PayPal account.

    The Create PayPal payment button page opens.

  4. In the Accept payments for dropdown menu, select "Donations."
  5. Enter the details for your payment button.
    • Organization name/service – (optional) Enter the purpose for the donation or the name of your organization. If you do not enter anything in this field, your donors can complete this field during checkout.
    • Donation ID – (optional) Enter a value to help identify different kinds of contribution payments. For example, you might enter the name of your current fund-raising campaign. Donors see the value that you entered at the time of payment. The value appears in the transaction details that contribution coordinators and donors can view on the PayPal website.
  6. Customize the appearance and the language of your button (optional).
    Click the Customize appearance link and select one of the following.
    • PayPal button – Select this radio button to use a button image that is hosted by PayPal. You can configure the size of the button, specify whether the button displays payment card logos, and specify the country and language for the button text.

    • Use your own button – Select this radio button to specify the URL of your own button image that is not hosted by PayPal. Use your own button image if the buttons hosted by PayPal do not fit the look of your website.
      If your image is hosted securely, change the text box to begin with https://.
  7. From the Currency dropdown menu, select the currency in which contributions are made; the dropdown menu automatically selects the currency of your primary balance.
  8. Under Contribution amount, select one of the following radio buttons.
    • Donors enter their own contribution amount – Select this radio button to let donors enter their contribution amounts during checkout.
      This is the default choice for this feature.
    • Donors contribute a fixed amount – Select this radio button and enter a fixed amount that donors contribute when they click this Donate button.
  9. Choose between your merchant ID and your email address.
    Select one of the following radio buttons to associate transactions from your button with your PayPal account.
    • Secure merchant account ID – Select this radio button to associate your button with your PayPal account by using your merchant ID. PayPal assigns a unique merchant ID to your account and includes it automatically in the code for your button.
      Only PayPal can match your secure merchant ID and PayPal account. When you use a secure merchant ID, your PayPal email address is not exposed in the HTML button code of your webpages.
      This is the default choice for this feature.

    • Plain text email – Select this radio button to associate your button with your PayPal account by using your email address. Select from the email addresses in your PayPal account. For example, you might select the email address of the person in your organization who handles order fulfillment or accounting. All payments are deposited to your PayPal account balance, regardless of which email address receives payments from this button. Only confirmed email addresses can be used to receive payments.
    Important: Your email address is a less secure way to associate your button with your PayPal account than use of your merchant ID. Your email address is exposed on webpages wherever you paste the HTML code for your button.
  10. Do one of the following:

Step 2 – Saving Your Donate Button in Your PayPal Account

Use the Step 2 section of the button creation tool to control whether to save the important details of your button in your PayPal account.

  1. Do one of the following:
    • Clear the Save button at PayPal checkbox to avoid saving your button in your PayPal account.
      The HTML code that PayPal generates and that you paste onto your webpage contains all payment details and information identifying your PayPal account. You may need to take extra precautions to secure your buttons against fraudulent payments.
      For more information, see Securing Your PayPal Payments Standard Buttons.
    • Select the Save button at PayPal checkbox to save the payment details of your donate button in your PayPal account.
      The HTML code that PayPal generates and that you paste onto your webpage contains no payment or identifying information.
      For more information, see Saving Donate Buttons in Your PayPal Account.
  2. Do one of the following:

Step 3 – Adding Advanced Features to Your Donate Button

Use the Step 3 section of the button creation tool to specify advanced features of your button.

  1. Can your donors add special instructions in a message to you (optional)?
    • Yes – Select this radio button to let donors add special instructions to you during checkout.
      In the Name of message box text box, enter the text that you want displayed for the text box in which donors enter their special instructions; the default value is "Add special instructions to the seller". Change the default value to prompt donors for specific information, such as In memory of. Enter no more than 40 characters.

      "Yes" is the default choice for this feature.

    • No – Select this radio button if you do not want a text box for special instructions.
  2. Do you need your donors' shipping addresses (optional)?
    • Yes – Select this radio button to prompt donors to select or enter shipping addresses during checkout.
      "Yes" is the default choice for this feature.
    • No – Select this radio button if you do not want to prompt donors for shipping addresses.
  3. Take donors to a specific webpage (URL) after checkout cancellation (optional)?
    Select the checkbox and enter a URL in the text box if you have a special page on your website where you want donors to return if they cancel their checkouts before completing their transactions.
  4. Take donors to a specific webpage (URL) after successful checkout (optional)?
    Select the checkbox and enter a URL in the text box if you have a special page on your website where you want donors to return after they complete their checkouts successfully.
    Note: If you have a special webpage for donors who return to your website after checking out successfully, consider implementing Payment Data Transfer so that you can display information about the completed transactions.
     
    To learn more, see the Payment Data Transfer webpage on PayPal Developer Network.
  5. Add advanced variables to the HTML code of your payment button (optional).
    If you are familiar with the HTML programming and the advanced HTML variables supported by PayPal Payments Standard payment buttons, you can enter them here. Select the checkbox, and then enter the variables in the text box that appears below it.
    Enter any advanced HTML variables in the following name/value-pair format:
    variableName=allowableValue
    

    For example, you want PayPal to display custom payment pages during checkout that you set up in your account profile. Use the HTML variable page_style with the name you gave to your custom payment page. If you were to include the variable in HTML code that you write manually, you would use the standard HTML format:

    <input type="hidden" name="page_style" value="myPageStyle">
    

    Enter the variables in the text box using the shortened, name/value-pair format instead:

    page_style=myPageStyle
    

    Do not enclose values in quotes, even if values contain spaces. PayPal surrounds the value from the equal sign (=) to the end of the line with quotes in the generated HTML code.
    For more information, see HTML Form Basics for PayPal Payments Standard.

  6. Do one of the following:

Copying and Pasting the Donate Code

After you click the Create Button button, PayPal displays the You are viewing your button code page. The page contains tabs with Donate code for specific situations:

  • Website – Copy and paste the HTML button code on this tab onto the pages of your website.
  • Email – Copy and paste the URL email payment link code on this tab into email templates and messages, or paste it onto webpages if your hosting provider does not allow you to paste HTML code.

Regardless of saving your buttons in your PayPal account, you must copy and paste the code that PayPal generates onto your own webpages and into email templates and messages.

Copying and Pasting the HTML Code for the Donate Button

The Website tab on the You are viewing your button code page contains the generated HTML code for your Donate payment button.

If in Step 2 – Saving Your Donate Button in Your PayPal Account you specified that you do not want to save your button in your PayPal account, PayPal protects the generated HTML button code with encryption. Protected HTML code helps secure your buttons against malicious tampering and fraudulent payments.

You can the expose the code of your payment button by clicking the Remove code protection link at the upper right of text box. For example, you might remove protection so that you can edit the code later to change the item price. If you remove code protection, you must use other methods that PayPal recommends to secure your payment button. Click the Protect code link to restore the button protection that you removed.

Important: Merchants with significant payment volume are required to take precautions on securing PayPal Payments Standard buttons.
 
For more information, see Securing Your PayPal Payments Standard Buttons.

To copy and paste the HTML code for your Donate payment button:

  1. Click the Select Code button on the Websites tab to select all of the generated HTML code.
  2. Copy the text that you selected to the clipboard, by:
    • Pressing Ctrl+C.
      – or –
    • Right-clicking your mouse, and selecting Copy.
  3. In your web editing tool, open the webpage where you want the button.
    Important: Be sure that your tool is ready for you to paste HTML code, such as by switching to an HTML view from a design view of your webpage.
  4. Paste the text that you copied from the clipboard onto your webpage where you want the button to appear, by:
    • Pressing Ctrl+V.
      – or –
    • Right-clicking your mouse, and selecting Paste.

Copying and Pasting the Code for the Donate Email Payment Link

The Email tab on the You are viewing your button code page contains the generated URL code for your Donate email payment link.

Note: PayPal cannot protect the URL code for email payment links. Secure the payments you receive from email payment links by using an alternative method that does not involve encryption, as described in Securing Your PayPal Payments Standard Buttons.

To copy and paste the URL code for your Donate email payment link:

  1. Click the Select Code button on the Email tab to select all of the generated URL code.
  2. Copy the text that you selected to the clipboard, by:
    • Pressing Ctrl+C.
      – or –
    • Right-clicking your mouse, and selecting Copy.
  3. Open the email template or message that you want to send.
  4. Paste the text that you copied from the clipboard into your email, by:
    • Pressing Ctrl+V.
      – or –
    • Right-clicking your mouse, and selecting Paste.

Avoiding Problems With Pasted HTML Code

After you paste the code onto your webpage or into your email, ensure that it matches exactly the code that you copied from PayPal. Pasted code may not match the generated code for the following reasons:

  • You did not copy all of the generated code.
  • Your editing tool may have special areas for pasting HTML code and other areas for pasting URLs and display text. Be sure you paste the generated code into a field that accepts HTML code or URLs.
  • Your editing tool might change some characters in the pasted code.

Sample HTML Code for Donate Buttons

The sample HTML code in this section demonstrates various features of PayPal hosted Donate buttons.

Important: This section includes unencrypted button code examples for illustrative purposes only. In reality, you must always use encrypted or hosted buttons in your webpages to prevent malicious users from tampering with the code. See Securing Your PayPal Payments Standard Buttons for instructions.

Sample HTML Code for a Basic Donate Button

The sample HTML code below illustrates a basic Donate button where donors enter their own contribution amount during checkout. The code uses the currency_code variable to set the currency for the contribution amounts that donors enter.

<form action="https://www.paypal.com/cgi-bin/webscr" method="post">

    <!-- Identify your business so that you can collect the payments. -->
    <input type="hidden" name="business"
        value="donations@kcparkfriends.org">

    <!-- Specify a Donate button. -->
    <input type="hidden" name="cmd" value="_donations">

    <!-- Specify details about the contribution -->
    <input type="hidden" name="item_name" value="Friends of the Park">
    <input type="hidden" name="item_number" value="Fall Cleanup Campaign">
    <input type="hidden" name="currency_code" value="USD">

    <!-- Display the payment button. -->
    <input type="image" name="submit" border="0"
    src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif"
    alt="PayPal - The safer, easier way to pay online">
    <img alt="" border="0" width="1" height="1"
    src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" >

</form>

The sample code above produces the following result:

Paste the code onto your website wherever you want donors to click and make a contribution in amounts that donors choose.

Sample HTML Code for a Donate Button With a Fixed Contribution Amount

The sample HTML code below illustrates a Donate button where the contribution amount that donors make is fixed and cannot be changed. The code uses the amount and the currency_code variables to set fixed contribution amount at $25.00 USD.

<form action="https://www.paypal.com/cgi-bin/webscr" method="post">

    <!-- Identify your business so that you can collect the payments. -->
    <input type="hidden" name="business"
        value="donations@kcparkfriends.org">

    <!-- Specify a Donate button. -->
    <input type="hidden" name="cmd" value="_donations">

    <!-- Specify details about the contribution -->
    <input type="hidden" name="item_name" value="Friends of the Park">
    <input type="hidden" name="item_number" value="Fall Cleanup Campaign">
    <input type="hidden" name="amount" value="25.00">
    <input type="hidden" name="currency_code" value="USD">

    <!-- Display the payment button. -->
    <input type="image" name="submit" border="0"
    src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif"
    alt="PayPal - The safer, easier way to pay online">
    <img alt="" border="0" width="1" height="1"
    src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" >
</form>

Creating Donate Buttons with JavaScript Disabled

The button creation tool on the PayPal website requires JavaScript. If JavaScript is disabled in your browser, PayPal offers you an alternative tool that does not require JavaScript.

Getting Started with Donate Button With JavaScript Disabled

To create a basic Donate button for your website with JavaScript disabled:

  1. Log in to your PayPal Premier or Business account at https://www.paypal.com.
    The My Account Overview page opens.
  2. Click the Edit Profile link.
    The Profile Summary page opens.
  3. Under the Selling Preferences heading, click the Create New Button link.
    The Create PayPal payment button page opens.
  4. Click the Donate link.

    The Donations page opens.

  5. Enter the donation details of your button.
    • Donation name/service – Enter the reason for the donation or the name of your organization. If you do not enter anything in this field, your donors can complete this field during checkout.
  6. Scroll to the bottom of the page, and click the Create Button Now button.
    The Add a Donate button to your website page displays the generated code.
  7. Click the HTML code for Websites text box to select all of the generated HTML code.
  8. Copy the text that you selected to the clipboard, by:
    • Pressing Ctrl+C.
      – or –
    • Right-clicking your mouse, and selecting Copy.
  9. In your web editing tool, open the webpage where you want the button.
    Important: Be sure that your tool is ready for you to paste HTML code, such as by switching to an HTML view from a design view of your webpage.
  10. Paste the text that you copied from the clipboard onto your webpage where you want the button to appear, by:
    • Pressing Ctrl+V.
      – or –
    • Right-clicking your mouse, and selecting Paste.

Creating Advanced Donate Buttons With JavaScript Disabled

The button creation tool for Donate buttons on the PayPal website requires JavaScript. If JavaScript is disabled in your browser, PayPal automatically offers you an alternative button creation tool that does not require JavaScript.

Read the following topics to learn how to create Donate buttons with JavaScript disabled.

Note: The alternative tool lets you create Donate buttons on the PayPal website, but it does not allow you to save your buttons in your PayPal account.

The Pages in the Button Creation Tool for Donate Buttons

The button creation tool for Donate buttons with JavaScript disabled has three pages:

  • Donations – the initial page to specify the required and most often used optional features
  • Donations – Page 2 – an optional page to specify additional, advanced features
  • Add a Donate button to your website – the final page that has the generated code for your payment button

You can switch between the first and second pages until you click the Create Button Now button to display the third page that has the generated code.

Page 1 – Specifying the Basic Features of the Donate Button

To create code for a Donate button or email payment link by using a tool on the PayPal website with JavaScript disabled:

  1. Log in to your PayPal account at https://www.paypal.com.
  2. Click the Edit Profile link.
    The Profile Summary page opens.
  3. Under the Selling Preferences heading, click the Create New Button link.
    The Create PayPal payment button page opens.
  4. Under the Create button without JavaScript enabled heading, click the Donate link.

    The Donations page opens.

  5. Enter the donation details of your button.
    • Donation name/service – Enter the reason for the donation or the name of your organization. If you do not enter anything in this field, your donors can complete this field during checkout.
    • Donation ID/number – (optional) Enter a value to help identify different kinds of contribution payments. For example, you might enter the name of your current fund-raising campaign. The value that you enter is displayed to donors at the time of payment, and it is displayed in the transaction details that both contribution coordinators and donors can view on the PayPal website.
    • Amount – (optional) Enter a fixed contribution amount. If you leave the field blank, donors enter their own contribution amount after they click the Donate button.
    • Currency – From the dropdown menu, select the currency in which you specified the fixed contribution amount or in which you want the amounts that donors enter to be denominated. The dropdown menu automatically selects the currency of your primary balance.
    • Buyer's default country – From the dropdown menu, select a country for the PayPal log-in or sign-up page that donors see when they click the button. The content on the page will be appropriate for the country you select. Donors can change the country that you select, after the log-in or sign-up page appears.
  6. Choose a button style for your Donate button.
    Select the radio button next to the image that you want to use, if you are going to be accepting payments from your website instead of by using an email payment link. The image that you select is hosted by PayPal.

    To display your own image that you host on your website:

    • Click the Use your own button image link.
      An additional radio button and text box appear.
    • In the Button Image URL text box, enter the URL of your button image.
      If your image is hosted securely, change the entry to begin with https://.
  7. Specify whether to use button encryption.
    • Select the Yes radio button to encrypt the generated code for the payment button.
      – or –
    • Select the No radio button to leave the generated code for the payment button and the email payment link as clear text.

    PayPal highly recommends that you use button encryption to protect the HTML code of your payment button. Encryption protects payment details from fraudulent alteration by third parties, thus increasing the security of the payments you accept. However, consider the limitations that encryption imposes:

    • Encrypted HTML code cannot be edited.
      Select the No radio button if you want to edit the HTML code for your button after the code is generated.
    • Encrypted HTML code cannot be used for email payment links.
      Select the No radio button if you want to create an email payment link instead of or in addition to your button.

    If you select the No radio button for any reason, use an alternative strategy described in Securing Your PayPal Payments Standard Buttons, to secure the payments you receive from the payment button or the email payment link.

    Important: Merchants with significant payment volume are required to take precautions on securing PayPal Payments Standard buttons.
  8. If you have additional details to specify for your button, such as a custom payment page that has your own logo and colors, click the Add More Options button and follow the instructions for Page 2 – Specifying Advanced Features of Your Donate Button."
    – or –
    If you entered all the details and options for your button, go to Copying and Pasting the Donate Code With JavaScript Disabled."

Page 2 – Specifying Advanced Features of Your Donate Button

Use the Donations – Page 2 page to specify advanced features of your button with JavaScript disabled.

  1. Customize your payment pages.
    Use these settings to give donors a visually seamless payment experience by customizing the PayPal payment pages to match the visual style of your website.
    • Primary Page Style – (display only) The payment pages that your donors see are displayed with the page style that is specified here, unless you select a different custom payment page style below.
    • Custom Payment Page Style – (optional) If you already added Custom Payment Page Styles in your account profile, they are listed here. Choose the page style that you would like to appear when donors click your Donate button.
      To learn more about creating page styles, see Co-Branding the PayPal Checkout Pages.
    • Preview – Click the Preview button to see a mock-up of the payment page style that donors see when they click your Donate button.
  2. Customize your donor's experience.
    Use these settings to give donors a payment experience that is easy to navigate.
    • Successful Payment URL – (optional) Do one of the following:
      Enter the URL of a page on your website that you want donors redirected to after they complete their payments. Only this payment button uses the URL that you enter.
      Click the Edit button to change the return URL that this button and all your other payment buttons use to redirect donors to your website after they complete their payments. For more information, see Auto Return.
    • Payment Data Transfer – Click the Edit button to turn Payment Data Transfer on or off for all your payment buttons.

      To learn more, see the Payment Data Transfer webpage on PayPal Developer Network..

    • Cancel Payment URL – (optional) Enter the URL for the page on your website that you want donors redirected to if they cancel their payments at any point before completing the checkout. If you do not enter a URL, subscribers see a PayPal webpage. Only this payment button uses the URL that you enter.
  3. Select your shipping preferences.
    Select the radio button that matches your need to collect addresses from donors:
    Make shipping optional – Select this radio button if you want to prompt donors to enter their addresses as an option.
    – or –
    Yes, require shipping – Select this radio button if you want to require donors to enter their addresses.
    – or –
    No shipping needed – Select this radio button if you do not require addresses from donors.
    You might want to collect addresses from donors so that you can send paper contribution acknowledgement letters or ship contribution thank-you gifts.
  4. Collect notes and special instructions from donors.
    Use these settings to prompt donors to enter notes or special instructions.
    • Select the Yes radio button if you want donors to enter notes to you when they make their payments. If you leave the No radio button selected, donors cannot include notes.
    • Note Title – If you selected the Yes radio button, change the default value for the field label to prompt donors for specific information, such as In memory of. Enter no more than 30 characters.
  5. Choose an email address to receive payment.
    (optional) In the Email Address dropdown menu, select the email address through which you want to receive payments when people click the payment button that you are creating. The dropdown menu selects your primary email address by default. You might select the email address of the person in your organization who handles accounting. All payments are deposited to your PayPal account balance, regardless of which email addresses receive particular payments. Only confirmed email addresses can be used to receive payments.
  6. If you want to change any of the details that you entered on the previous page, click the Edit button and follow the instructions for Page 1 – Specifying the Basic Features of the Donate Button, beginning with Step 5.
    – or –
    If you have entered all the details and options for your button, go to Copying and Pasting the Donate Code With JavaScript Disabled.

Copying and Pasting the Donate Code With JavaScript Disabled

After you enter the basic and advanced features that you want for your Donate button, click the Create Button Now button. PayPal generates Donate code for:

  • a payment button, which you can paste onto your website
  • an email payment link, which you can paste into email

The Add a Donate button to your website page displays the generated code.

Copying and Pasting the HTML Code for the Donate Button With JavaScript Disabled

To copy and paste the HTML code for the Donate payment button:

  1. Click the HTML code for Websites text box to select all of the generated HTML code.
  2. Copy the text that you selected to the clipboard, by:
    • Pressing Ctrl+C.
      – or –
    • Right-clicking your mouse, and selecting Copy.
  3. In your web editing tool, open the webpage where you want the button.
  4. Paste the text that you copied from the clipboard onto your webpage where you want the button to appear, by:
    • Pressing Ctrl+V.
      – or –
    • Right-clicking your mouse, and selecting Paste.
Copying and Pasting the Code for the Donate Email Payment Link With JavaScript Disabled

PayPal does not generate code for email payment links if you select the Yes radio button in the Button Encryption section on the first page of the button creation tool. To turn button encryption off, return to the first page and click the No radio button in the Button Encryption section. Then click the Create Button Now button again.

Note: You cannot use Encrypted Website Payments to encrypt the code for email payment links. Secure the payments you receive from email payment links by using an alternative method that does not involve encryption, as described in Securing Your PayPal Payments Standard Buttons.

To copy and paste the code for the Donate email payment link:

  1. Click the Link for Emails text box to select all of the generated URL code.
  2. Copy the text that you selected to the clipboard, by:
    • Pressing Ctrl+C.
      – or –
    • Right-clicking your mouse, and selecting Copy.
  3. Open the email template or message that you want to send.
  4. Paste the text that you copied from the clipboard into your email, by:
    • Pressing Ctrl+V.
      – or –
    • Right-clicking your mouse, and selecting Paste.
Creating More Donate Buttons With JavaScript Disabled

After you copy and paste the Donate code, you can create another Donate button for a different contribution purpose or amount. Scroll to the bottom of the Add a Donate button to your website page and click the Create Another Button button. Then follow the instructions for Page 1 – Specifying the Basic Features of the Donate Button, beginning with Step 5. The pages of the button creation tool retain the options that you previously specified.

Limitations When Creating Payment Buttons With JavaScript Disabled

The alternative tool that works with JavaScript disabled lets you create Donate buttons on the PayPal website. However, the following features are not supported by the alternative tool:

  • Saving your buttons in your PayPal account
  • Language choices for button images
  • Creating payment buttons before you create your PayPal account

To use any of the above features when creating payment buttons on the PayPal website, you must enable JavaScript in your browser.

For more information, see Enabling JavaScript in Your Browser.

Enabling JavaScript in Your Browser

PayPal recommends that you keep JavaScript enabled at all times. Many features of the PayPal website require that JavaScript be enabled in your browser.

Read one of the following topics to learn how to enable JavaScript in your browser.

After you enable JavaScript in your browser, you can create a basic Donate button by following the instructions for Using the Button Creation Tool for a Basic Donate Button.

Enabling JavaScript in Internet Explorer

To enable JavaScript in Internet Explorer:

  1. Select Tools > Internet Options from the menu bar.
    The Internet Options dialog box opens.
  2. Click the Security tab.
  3. Click the Trusted sites icon.
  4. Click the Custom level button.
    The Security Settings dialog box opens.
  5. Scroll down to the Scripting section, and then select the Enable radio button as the option for active scripting.
  6. Click the OK button to dismiss the Security Settings dialog box.
    A Warning message box asks if you are sure you want to change the security settings.
  7. Click the Yes button to dismiss the message box.
  8. Click the OK button to dismiss the Internet Options dialog box.

Enabling JavaScript in FireFox

To enable JavaScript in Firefox:

  1. Select Tools > Options from the menu bar.
    The Options dialog box opens.
  2. Select the Content icon at the top of the dialog box.
  3. Select the Enable JavaScript checkbox.
  4. Click the OK button.