Tassos Docs

Advanced Custom Fields v3.1.8

Home / Advanced Custom Fields / Fields Types

PayPal Button Field

Q: How do I add a custom image as my PayPal button?

To add a custom image as your PayPal button, select Image in Button Type and select the image in Button Image, which appears below.

Q: How do I set the language of the checkout page?

To set the language of the checkout page, select Fixed in Language and enter the locale in Language Locale, which appears below. You can find a list of available locales here: Supported Locale Codes

Q: How do I test my PayPal button in sandbox mode?

To test your PayPal button in sandbox mode, enable Sandbox Mode and enter your PayPal sandbox email address in Sandbox Email Address, which appears below.

Q: How do I let users enter their own amount?

Select Checkout in Payment Type, enable Allow User to set price, and leave Price empty in the article.

Collect donations and sell products online with a custom PayPal button. Monetize your site and start earning today!

PayPal Button Field is available in Pro

Unlock this and dozens of other powerful features by upgrading to Advanced Custom Fields Pro.

Unlock this feature

The PayPal custom field gives you the ability to collect donations from around the world, allow your shoppers to buy products or subscribe to your services. It also provides a variety of settings that lets you modify the paypal button via a pre-defined list of images, upload your own, set the language of the checkout page and more. Below you can view all available settings.

How to add a PayPal Custom Field to Joomla Articles

Go to Content → Fields, click New, and select ACF - PayPal as the Type. Then configure the options below.

acf-paypal-field-settings

There are some required fields that you need to fill in order to display the PayPal button on your site. Start by choosing a Payment Type: Checkout, Donation, or Subscription.

acf-paypal-select-payment-type

Next, enter your email address in PayPal Email Address. It must belong to a PayPal business account.

acf-paypal-set-paypal-email-address

You can also test your PayPal button in sandbox mode by enabling the Sandbox Mode toggle and entering your PayPal sandbox email address in Sandbox Email Address. This way you can do some test purchases before you can make your button available site-wide.

acf-paypal-sandbox-test

Furthermore, you can set the currency in Currency, which will be used in the payments that will be made to your PayPal email address.

acf-paypal-set-currency

In addition, set Button Type to Style to pick one of the predefined buttons in Button Style, or set it to Image and upload your own button in Button Image.

Lastly, set Language to Auto to let PayPal choose the checkout language, or to Fixed and enter a code in Language Locale (for example en_US). You can find a list of available locales here: Supported Locale Codes

acf-paypal-set-locale

The next section contains a list of all the settings with a description for each.

Field Settings

Below you can find all available settings for the ACF - PayPal custom field.

Name	Description
Name	The name will be used to identify the field. Leave this blank and Joomla will fill in a default value from the title.
Label	The label of the field to display.
Description	A description of the field that will be displayed in the label tooltip.
Required	Is this a mandatory field?
Payment Type	Select a payment type. Checkout: A one time payment. Donation: A voluntary donation. Subscription: A recurring payment.
PayPal Email Address	Set your PayPal Email Address where you will receive the funds. This email needs to belong to a business PayPal account.
Currency	Select the currency which your users will pay for your products or services you are providing.
Allow User to set price	(Appears when you select Checkout on Payment Type) Leave the item price empty and let the user set a custom price on PayPal during checkout. When it's off, a Checkout button with no price isn't displayed.
Billing Interval	(Appears when you select Subscription on Payment Type) Set the duration of the subscription in days.
Button Type	Select the button type, either a style from our pre-defined list of buttons or use a custom image as your PayPal button.
Button Style	Select a button from our pre-defined list.
Button Image	(Appears when you select Image in Button Type) Set an image as your PayPal button.
Language	Set whether to keep the default language or apply a specific language on the PayPal checkout page.
Language Locale	(Appears when you select Fixed in Language) Set the locale of the language to be used in the PayPal checkout page. Supported Locale Codes
Return URL	Set the URL where the user will be redirected after successfully completing the transaction.
Cancel URL	Set the URL where the user will be redirected after cancelling the transaction.
Open PayPal in new tab	Enable to open PayPal in a new tab.
Sandbox Mode	Set whether to enable sandbox mode, used for debugging the PayPal button during development.
Sandbox Email Address	Enter your sandbox PayPal Email Address. If left empty, the PayPal Email Address will be used.

Usage

Edit your article and open the Fields tab (or the tab named after your field group) to see the PayPal custom field, as shown in the screenshot below.

acf-paypal-usage

Enter the Item Name and Price of the product or service you're selling.

Frontend Display

Take a look at the screenshot below to see how it could be displayed in your frontend.

acf-paypal-frontend

Frequently Asked Questions

How do I add a custom image as my PayPal button?

To add a custom image as your PayPal button, select Image in Button Type and select the image in Button Image, which appears below.

acf-paypal-select-custom-image

How do I set the language of the checkout page?

To set the language of the checkout page, select Fixed in Language and enter the locale in Language Locale, which appears below. You can find a list of available locales here: Supported Locale Codes

acf-paypal-set-locale

How do I set the subscription billing interval?

To set the billing interval for the subscription payment type, select Subscription in Payment Type and enter how often, in days, the subscription renews (for example 30) in Billing Interval, which appears below.

acf-paypal-subscription-billing-days

How do I test my PayPal button in sandbox mode?

To test your PayPal button in sandbox mode, enable Sandbox Mode and enter your PayPal sandbox email address in Sandbox Email Address, which appears below.

acf-paypal-sandbox-test

How do I get notified once payment was made?

The PayPal custom field does not support payment notifications as its sole purpose is to display a button and redirect your users to PayPal. PayPal, automatically sends you email notifications as you receive payments, donations or subscriptions. You can read more on PayPal's documentation here: How do I set up my email notification preferences?

How do I let users enter their own amount?

Select Checkout in Payment Type, enable Allow User to set price, and leave Price empty in the article.

How do I create a form with dynamic pricing for the PayPal button?

The PayPal custom field allows you to create a PayPal button, style it and add it to your Joomla site. It cannot accept dynamic pricing nor can be added to a form.

However, Convert Forms allows you to create a PayPal button that accepts dynamic pricing based on your user's selected fields and the prices you have specified. You can read more here: How to create a PayPal Joomla Form