Jump to main content Jump to doc navigation

If you haven't already make sure you have setup the product listing page, and adjusted the optionsResource value.

Minimum Call

[[!smCheckout]]

Available Properties

You can use all of the following properties in the smListProducts snippet, all of these are also available from the snippets' Properties tab.

Property Description Default
debug Set to 1 or true to output debug data on the screen. 0
redirect When enabled, the snippet will directly redirect to PayPal and not offer the payment options screen. 0
tpl Name of a chunk to use for the output of the snippet smcheckout.paymentoptions (included as file)
toPlaceholder The name of a placeholder to assign the output to. The snippet will, when set, output nothing.
return_id The ID of a Resource to be used for the next checkout step. This will be passed to PayPal.
cancel_id The ID of a Resource to be displayed when the PayPal authorization was cancelled.
fail_id The ID of a Resource to be displayed when the PayPal authorization or transaction failed.

This snippet also uses the following system settings for some parts of its behavior:

Verification is needed for this snippets use of these system settings.

Key Description
subscribeme.paypal.cancel_id Same as cancel_id
subscribeme.paypal.fail_id Same as fail_id
subscribeme.paypal.return_id Same as return_id

tpl

Default value (from core/components/subscribeme/elements/chunks/smcheckout.paymentoptions.tpl):

<style type="text/css">
    #paymentoptions {
    width: 600px;
    }
    #paymentoptions td {
    width: 50%;
    vertical-align: top;
    padding: 10px;
    text-align: center;
    }
    .paypal {
    border: 2px solid #ff9900;
    }
    .manual {
    border: 2px solid #000;
    }
</style>
<table id="paymentoptions">
    <tr>
    <td>
        <h3>Checkout with PayPal</h3>
        <p>By setting up a <strong>recurring payment</strong> via PayPal you will automatically be billed every [[+period]], maintaining your subscription state.</p>
        <p><a href="[[+paypalurl]]" title="Subscribe now!"><img src="http://www.paypal.com/en_US/i/btn/btn_subscribe_LG.gif" alt="Subscribe using PayPal" /></a></p>
        <p style="font-size: 80%">You will be able to cancel your subscription at any time via your PayPal profile. Your subscription will then be cancelled at the end of the running billing cycle.</p>
    </td>
    <td>
        <h3>Manual Payments</h3>
        <p>Using PayPal is free and automates the process of giving you access to the content you are subscribing to.</p>
        <p>If you wish to subscribe without PayPal you can do so by getting in touch - our staff will gladly help you get started.</p>
        <p><a href="">Contact us</a></p>
    </td>
    </tr>
</table>

Note: You should NOT edit the default file directly, as future updates will overwrite any changes to this file. It is highly recommended you duplicate the file, or create a chunk with the contents, updating the snippet call, or snippet parameters accordingly.

You should edit this chunk to include a valid Contact us link, if you wish to change the paypal button you can also do so here. The default button is best suited for websites with a white background.

If you dislike inline css and/or tables to format your content, you can also make those adjustments in this template.

PayPal Token

The smCheckout snippet sets up a token with PayPal. This token is only valid for approximately 3 hours. If you haven't already, you should setup a PayPal Sandbox account for testing.