PayWhirl

PayWhirl is a platform for creating subscription billing systems and embeddable payment widgets that can be added to websites to accept one-time or recurring payments.

Key features include:

Subscription plan management
One-time and recurring payment forms
Embeddable checkout widgets
Multi-product and multi-plan purchasing
Upsell and add-on purchase flows
Gift code purchasing and delivery

PayWhirl integrates with ShopWired by providing embeddable checkout widgets and buy buttons that can be added to website pages using custom HTML so you can accept payments and subscriptions directly from your website.

ShopWired can only provide support for the instructions in this help guide. For assistance with your PayWhirl account, contact PayWhirl support directly.

Account creation

Create an account on the PayWhirl website at PayWhirl.

After your account is created and configured, PayWhirl will provide widget embed code and buy button code that can be added to your website.

The Pricing Table widget displays subscription plans in a comparison table allowing customers to choose a single plan and complete checkout. Once configured in PayWhirl, copy the widget embed code and add it to your ShopWired website using a Custom HTML section.

To add the widget to your website, PayWhirl will provide code similar to the example below:

<script type="text/javascript" src="https://app.paywhirl.com/pwa.js"></script>
<script>
paywhirl('widget', {
    autoscroll: 1,
    domain: 'example',
    uuid: 'example-widget-id'
});
</script>

The code shown above is provided as an example only. You must copy the exact code provided in your own PayWhirl account, as the script and any ID values will be unique to your website.

Navigate to Website > Themes
Select customise your theme for the theme you want to edit
Select add a new section
Select the custom HTML section type
Paste the widget code into the Custom HTML setting
Position the section where the widget should appear and save your changes

To add a buy button instead of displaying the full widget, PayWhirl will provide code similar to the example below:

<script type="text/javascript" src="https://app.paywhirl.com/pwa.js"></script>
<script>
paywhirl('button', {
    autoscroll: 1,
    domain: 'example',
    uuid: 'example-button-id'
});
</script>

The code shown above is provided as an example only. You must copy the exact code provided in your own PayWhirl account, as the script and any ID values will be unique to your website.

Navigate to Website > Themes
Select customise your theme for the theme you want to edit
Select add a new section
Select the custom HTML section type
Paste the buy button code into the Custom HTML setting
Position the section where the button should appear and save your changes

The Payment Form widget provides a checkout form for accepting subscriptions or one-time payments from customers. Once configured in PayWhirl, copy the widget embed code and add it to your ShopWired website using a Custom HTML section.

To add the widget to your website, PayWhirl will provide code similar to the example below:

<script type="text/javascript" src="https://app.paywhirl.com/pwa.js"></script>
<script>
paywhirl('widget', {
    autoscroll: 1,
    domain: 'example',
    uuid: 'example-widget-id'
});
</script>

The code shown above is provided as an example only. You must copy the exact code provided in your own PayWhirl account, as the script and any ID values will be unique to your website.

Navigate to Website > Themes
Select customise your theme for the theme you want to edit
Select add a new section
Select the custom HTML section type
Paste the widget code into the Custom HTML setting
Position the section where the widget should appear and save your changes

To add a buy button instead of displaying the full widget, PayWhirl will provide code similar to the example below:

<script type="text/javascript" src="https://app.paywhirl.com/pwa.js"></script>
<script>
paywhirl('button', {
    autoscroll: 1,
    domain: 'example',
    uuid: 'example-button-id'
});
</script>

The code shown above is provided as an example only. You must copy the exact code provided in your own PayWhirl account, as the script and any ID values will be unique to your website.

Navigate to Website > Themes
Select customise your theme for the theme you want to edit
Select add a new section
Select the custom HTML section type
Paste the buy button code into the Custom HTML setting
Position the section where the button should appear and save your changes

The Multi-Select widget allows customers to choose multiple plans or products within the same checkout flow. Once configured in PayWhirl, copy the widget embed code and add it to your ShopWired website using a Custom HTML section.

To add the widget to your website, PayWhirl will provide code similar to the example below:

<script type="text/javascript" src="https://app.paywhirl.com/pwa.js"></script>
<script>
paywhirl('widget', {
    autoscroll: 1,
    domain: 'example',
    uuid: 'example-widget-id'
});
</script>

The code shown above is provided as an example only. You must copy the exact code provided in your own PayWhirl account, as the script and any ID values will be unique to your website.

Navigate to Website > Themes
Select customise your theme for the theme you want to edit
Select add a new section
Select the custom HTML section type
Paste the widget code into the Custom HTML setting
Position the section where the widget should appear and save your changes

To add a buy button instead of displaying the full widget, PayWhirl will provide code similar to the example below:

<script type="text/javascript" src="https://app.paywhirl.com/pwa.js"></script>
<script>
paywhirl('button', {
    autoscroll: 1,
    domain: 'example',
    uuid: 'example-button-id'
});
</script>

The code shown above is provided as an example only. You must copy the exact code provided in your own PayWhirl account, as the script and any ID values will be unique to your website.

Navigate to Website > Themes
Select customise your theme for the theme you want to edit
Select add a new section
Select the custom HTML section type
Paste the buy button code into the Custom HTML setting
Position the section where the button should appear and save your changes

The Upsells widget allows additional products or subscription add-ons to be offered during the checkout process. Once configured in PayWhirl, copy the widget embed code and add it to your ShopWired website using a Custom HTML section.

To add the widget to your website, PayWhirl will provide code similar to the example below:

<script type="text/javascript" src="https://app.paywhirl.com/pwa.js"></script>
<script>
paywhirl('widget', {
    autoscroll: 1,
    domain: 'example',
    uuid: 'example-widget-id'
});
</script>

The code shown above is provided as an example only. You must copy the exact code provided in your own PayWhirl account, as the script and any ID values will be unique to your website.

Navigate to Website > Themes
Select customise your theme for the theme you want to edit
Select add a new section
Select the custom HTML section type
Paste the widget code into the Custom HTML setting
Position the section where the widget should appear and save your changes

To add a buy button instead of displaying the full widget, PayWhirl will provide code similar to the example below:

<script type="text/javascript" src="https://app.paywhirl.com/pwa.js"></script>
<script>
paywhirl('button', {
    autoscroll: 1,
    domain: 'example',
    uuid: 'example-button-id'
});
</script>

The code shown above is provided as an example only. You must copy the exact code provided in your own PayWhirl account, as the script and any ID values will be unique to your website.

Navigate to Website > Themes
Select customise your theme for the theme you want to edit
Select add a new section
Select the custom HTML section type
Paste the buy button code into the Custom HTML setting
Position the section where the button should appear and save your changes

The Gift Code widget allows customers to purchase gift codes that are delivered to a recipient by email. Once configured in PayWhirl, copy the widget embed code and add it to your ShopWired website using a Custom HTML section.

To add the widget to your website, PayWhirl will provide code similar to the example below:

<script type="text/javascript" src="https://app.paywhirl.com/pwa.js"></script>
<script>
paywhirl('widget', {
    autoscroll: 1,
    domain: 'example',
    uuid: 'example-widget-id'
});
</script>

The code shown above is provided as an example only. You must copy the exact code provided in your own PayWhirl account, as the script and any ID values will be unique to your website.

Navigate to Website > Themes
Select customise your theme for the theme you want to edit
Select add a new section
Select the custom HTML section type
Paste the widget code into the Custom HTML setting
Position the section where the widget should appear and save your changes

To add a buy button instead of displaying the full widget, PayWhirl will provide code similar to the example below:

<script type="text/javascript" src="https://app.paywhirl.com/pwa.js"></script>
<script>
paywhirl('button', {
    autoscroll: 1,
    domain: 'example',
    uuid: 'example-button-id'
});
</script>

The code shown above is provided as an example only. You must copy the exact code provided in your own PayWhirl account, as the script and any ID values will be unique to your website.

Navigate to Website > Themes
Select customise your theme for the theme you want to edit
Select add a new section
Select the custom HTML section type
Paste the buy button code into the Custom HTML setting
Position the section where the button should appear and save your changes

Recommendations

Use separate landing pages for different PayWhirl widgets where different payment flows are required
Test PayWhirl widgets on a draft theme before publishing them to your live website
Keep a record of which PayWhirl widgets are installed and where their embed code is placed
Use buy buttons when you want the checkout to open in a modal instead of displaying the full widget