eCommerce: QuickShop Recurring Subscription Payments
Using the QuickShop plugin you can create a Recurring Subscription button to receive payments on a regular daily, weekly, monthly or yearly basis.
To use this, your customer must have a PayPal account, or if they don’t already have one, they will be prompted to create one then and there. The owner of the PayPal account can login to their PayPal account to cancel a subscription at any time.
| OM4 Test Subscription $50 AUD per month |
(You can click this button to see how it appears in PayPal, just don’t go on and complete the payment)
Preparation
If you don’t have a PayPal account yet or don’t have the OM4 Quickshop plugin activated, activate the Quickshop plugin and configure it.
How to add a Subscription button
PayPal subscribe buttons are created using the following shortcode:
The variables that are used with a Subscription short code are as follows (bolded variables are mandatory):
| Variable | Description | Description/Allowable Values |
| Your email address used for PayPal | ||
| name | Name | Your descriptive name for the subscription |
| id | ID | Your identifier code for the subscription |
| amount | Amount | The amount of the regular subscription payment |
| howoften | How Often | Subscriptions can be set up to occur every period (1), every 2nd period (2), every 3rd period (3) etc Allowed values: positive integer 1, 2, 3 etc |
| time | Time Period | Time period for subscription. Allowed values: day, week, month, year |
| numpayments | Number of Payments | End the subscription automatically after a number of payments. Allowed values: Integer greater than one (2, 3, 4 etc). |
| currency | Currency | PayPal currency codes, defaults to your PayPal default currency if blank. Allowed values: AUD, USD, EUR, GBP, CAD. See all currency codes |
| locale | Locale | PayPal locale (country) codes. Allowed values: AU, DE, FR, IT, GB, ES, US |
Getting the combination of howoften and numpayments can be a bit tricky, you may find it useful to think of the settings using this form:
- Every (howoften) (time) for (numpayments) payments
- Every 3rd month for 4 payments (howoften=3 time=month numpayments=4)
- Every 1 month for 12 payments (howoften=1 time=month numpayments=12)
- Every 2 months (howoften=2 time=month)
Here are some examples of Subscription buttons for different combinations. Note currency and locale will be the default for your PayPal account unless you set them otherwise.
$50 per month subscription with no end date:
50 Euros per month subscription with no end date
$30 per month for 4 months:
$80 every 3 months:
$150 per year for 2 years: