WooCommerce

Run SellAbroad on WooCommerce with our plugin. Install it once, then pick one of two ways for international buyers to pay — both configured from the plugin's settings, with no theme edits:

• Payment Container — a Pay with Credit/Debit option inside your own WooCommerce checkout. Buyers pay without leaving your checkout page.
• Hosted Checkout — buyers go from your checkout to the full SellAbroad checkout, embedded on a page of your own store so your web address stays in the browser, and return to your store once the order is placed.

The plugin handles the cart, currency, tax, order creation, and webhooks for you — you never send us amounts or write any webhook handling. Only one mode runs at a time; you switch between them on the plugin's General tab.

Install and connect the plugin

These steps are the same whichever mode you choose.

1. Install the plugin

From SellAbroad you need your Merchant ID, your API key (the x-api-key), and the plugin ZIP. In your WordPress admin, go to Plugins → Add New → Upload Plugin, choose the ZIP, and activate it — a Payment Container item appears in your admin sidebar.

Open it and, on the Live Credentials tab, enter your Merchant ID and API key. Leave Shared secret blank — registering the store (step 3) fills it in for you.

2. Add your WooCommerce REST API key

The plugin needs a WooCommerce REST API key so SellAbroad can read and update your orders. In WooCommerce → Settings → Advanced → REST API, create a key with Read/Write permissions, then paste the Consumer key and Consumer secret into the same settings screen and Save.

3. Register your store

On the Setup Actions tab, click Register store. This is the step that turns the integration on: it validates your WooCommerce REST credentials, provisions your shared secret automatically, registers the webhook URL SellAbroad uses to notify your store, and activates your store for checkout. Skip it and checkout stays switched off — every buyer's cart is rejected.

If it reports that checkout did not activate, click Register store again, or contact SellAbroad support. Then click Test connection to confirm your credentials reach SellAbroad.

Choose how buyers pay

On the General tab, turn on Enable SellAbroad on this store (the master switch), then pick a Checkout mode. Switching modes keeps all your credentials and settings — it only changes where buyers pay.

Payment Container

SellAbroad appears as a Pay with Credit/Debit option alongside your other payment methods, on both the classic checkout and the Checkout Block. It runs off WooCommerce's own Place Order button, so there is never a second, conflicting button.

To finish enabling it, go to WooCommerce → Settings → Payments and switch on Payment Container. Buyers in your target markets can now pay without leaving your checkout.

Hosted Checkout

Buyers who reach your checkout page are sent to the SellAbroad checkout to pay. The plugin adds a checkout page to your own store that embeds the SellAbroad checkout in a full-screen iframe, so your web address stays in the buyer's browser through the whole payment. Buyers return to your store once the order is placed.

• Buyers see prices and pay in their own local currency; your catalogue stays in your store currency. (Some methods, buy-now-pay-later in particular, are only offered in the currencies those providers support.)
• While Hosted Checkout is on, the SellAbroad payment method does not appear on your own checkout.
• On the Setup Actions tab, use Test handover to check the connection, the cart handover, and your registration in one click. This is worth running because a broken handover falls back to your normal WooCommerce checkout rather than showing an error, which is otherwise hard to notice.

Taxes

When SellAbroad is the merchant of record for a payment, we calculate the correct tax for the buyer's destination, charge it, and show it as a labeled Tax line.

In Payment Container mode that line appears on your WooCommerce checkout, the order confirmation page, and order emails. On plugin 1.2.2 and later this works even when WooCommerce's own tax calculation is turned off; on older versions the tax is still charged, but the line only appears when WooCommerce taxes are enabled (WooCommerce → Settings → General → Enable taxes) — so keep them on or update the plugin. In Hosted Checkout mode the tax is calculated and shown on the SellAbroad checkout.

If your store calculates its own tax and SellAbroad has configured your account to use it, none of this applies: your own tax stays in place.

Apple Pay and Google Pay

The plugin can also offer Apple Pay and Google Pay at checkout, with the delivery address taken from the wallet sheet. It is off by default — enable the wallet gateway in your SellAbroad payment settings. Apple Pay additionally needs a verification file served on your domain; see Apple Pay.

Go live

Once your store is registered and a checkout mode is enabled, you are live. International orders appear in both WooCommerce and your SellAbroad dashboard — the plugin creates the WooCommerce order and keeps it in sync from SellAbroad's webhooks, so nothing else is needed on your side.

Buyers seeing an error, no payment option, or a payout that won't unlock? See Troubleshooting.