Getting paid with PayPal

PayPal is the most popular payment gateway for online transactions for very small businesses. A PayPal plugin is provided to get you started immediately. You do need a PayPal account for that and you do need to configure the plugin before even trying to test it.

The PayPal plugin allows for only one instance on a page, extra instances will be replaced with an appropriate message. However, it can be used in conjunction with other plugins for other payment gateways on the same page. Nothing prohibits you to propose a PayPal checkout as well as a Google Checkout, iDeal, Moneris or any other payment gateway for which you have a plugin. They should be designed to appear all on the same page.

{ scpaypal type=checkout } The plugin on this page is not connected to a shopping cart, clicking will result in a PayPal error…

Reseller email is not entered, please add this to the configuration first. PayPal cannot be used!

 Joomla 2.5 makes use of email cloaking by default. You also need to add { emailcloak=off } on this page for Paypal to work.

Please note that clients do not necessarily need a PayPal account to be able to pay you.

The PayPal plugin can take 4 (four) type parameters:


The standard checkout method. It provides you with a PayPal button to click so clients can go and pay with their PayPal account.


This plugin call allows you to say Thank-You for the payment and sets the order status to Paid. The page on which this plugin appears is your PayPal success url, in the plugin parameters called “URL to return to after successful payment”.

The url must be an absolute url meaning you must include the http:// or https:// part.


As should be obvious, this is where you lead your clients when they cancel the payment at the very last moment, perhaps because of a forgotten PayPal password. In the plugin settings the url to enter for failed payments is called “URL to return to after failed or cancelled payment”.

The url must be an absolute url meaning you must include the http:// or https:// part.


PayPal allows for IPN, or Instant Payment Notification. This is basically the same as the pay success option, but delivers no visual return and is always used, even if the client does not return to your site after payment. IPN should be activated first and settings should be entered in your PayPal account.

The url must be an absolute url meaning you must include the http:// or https:// part.

Configuring the PayPal plugin

PayPal needs a configuration information in order to operate properly. By default upon installation, the plugin will be directed to the Sandbox environment. This security measure makes sure you configure your PayPal settings before you start selling.

To configure the PayPal plugin, go to Extensions > Plugin manager and find the SimpleCaddy Paypal plugin. The configuration screen will look like this:


Even if all is relatively self explanatory, the Reseller email is YOUR PAYPAL email. Do not leave the pre-entered email in place. Also, you need to select your own PayPal currency. Once you have set up the Payment Success page and Payment Fail pages, enter their urls in here as well.

Note that the currency you set here is not related to the currency you set in the SimpleCaddy Configuration! The one in the SimpleCaddy Configuration is only for display purposes.

Then set the environment to Live and save the plugin settings. From here on it should be smooth sailing to get paid.

Update for v2.0.4

Since version 2.0.4 the number of urls poresented to you is defined by the number of languages your site is using. If your site is only in one language, there will be no difference with the previous versions. However, if you have a mulitple language site (let's say English and French) you will see two sets of urls, one set for each language on your site.

This allows you to set the PayPal return urls for a specific language. In this way you can thank your clients in the language they have chosen for your site.