Documentation

WooCommerce – getting started

Create an account and download the plugin – or start right in WordPress: the plugin can create your account during the connection.
In WordPress go to Plugins → Add New → Upload Plugin, upload the ZIP and activate it.
Open WooCommerce → MrUpsell and click Connect to MrUpsell. Confirm your shop on mrupsell.com and you are sent straight back – connected with one click, no keys to copy.
Create your first rule under WooCommerce → MrUpsell → Offers.

Requirements

WordPress 6.2+, WooCommerce 8+, PHP 8.1+, HTTPS.
For one-click: WooCommerce Stripe Gateway and/or WooCommerce PayPal Payments (≥ 4.1.2, vaulting enabled).

Set up payments for one-click

MrUpsell charges the upsell through the payment plugin your store already uses – the money goes straight to your own Stripe or PayPal account. You need no additional keys and no new payment provider.

Stripe (cards, Apple Pay, Google Pay): Install the official WooCommerce Stripe Gateway and enable card payments. That is all – as soon as a MrUpsell rule is active, the card is automatically kept usable for the follow-up charge during the first purchase. If the bank requires 3-D Secure, the customer confirms right on the thank-you page.
PayPal with one click: Use WooCommerce PayPal Payments 4.1.2 or newer, enable vaulting (“Save PayPal and Venmo”) there and switch on PayPal one-click under WooCommerce → MrUpsell → Settings. PayPal must have enabled vaulting for your merchant account.
PayPal with two clicks (default): Without vaulting, MrUpsell briefly redirects the customer to PayPal for the upsell – their details are already filled in. Choose this if you want to keep “Pay Later”/instalments in the PayPal window: with vaulting enabled PayPal hides those options.
Other payment methods (invoice, bank transfer, Klarna, SEPA …): the offer is simply not shown for those orders – nothing changes at checkout.
Testing: Enable your payment plugin's test mode, place a test order and accept the offer. The MrUpsell box on the order screen in the WooCommerce admin shows for every order why an offer was or was not displayed – or append ?mrupsell_debug=1 to the thank-you page URL as a shop manager.

Shopify – getting started

Install MrUpsell from the Shopify App Store and approve the usage charge (the revenue share is billed by Shopify).
Go to Settings → Checkout → Post-purchase page and select MrUpsell.
Create your first rule in the MrUpsell admin inside Shopify.
Your MrUpsell dashboard account is created automatically (sign-in link by email). To show the store in another workspace, use a link code from Dashboard → Shops → Link Shopify store.

Offer rules

A rule has a trigger (products or categories, order total, customer type, payment methods), one to three funnel steps (always / after accept / after decline), a countdown and optional design overrides. Exactly one rule is shown per order – the one with the lowest priority number that matches.

Pricing and billing

There are no plans and no subscription. MrUpsell charges 3 % of the upsell revenue it generates (accepted upsell orders minus refunds), billed weekly in arrears. Every feature is included: unlimited rules, 3-step funnels and unlimited shops. Fees are calculated from the upsell orders your shop reports – every billed order is listed in the dashboard.

WooCommerce: save a card or PayPal under Dashboard → Billing – offers only go live once a payment method is on file, and nothing is charged upfront. Shopify: the fee is a capped usage charge on your Shopify invoice, and your MrUpsell dashboard account is created automatically when you install the app.

API for developers

The hub API (/api/v1) is used internally by the plugin and the Shopify app – it is not a public API. Planning an integration? Write to us at info@mrupsell.com.