WooCommerce plugin — 1-click install

The fastest way to connect a WooCommerce store to WooshPayment: install the official plugin, activate it, done. No PHP snippets in your theme, no API keys to generate (for the redirect part), no extra Code Snippets plugin.

Prerequisites

• WordPress 6.0+ with WooCommerce 7.0+ active
• "Post name" or similar permalink structure enabled (WP Admin → Settings → Permalinks → anything other than "Plain"). Required for the WC Store API the plugin calls.
• Permission to install plugins (Administrator role)
• A WooshPayment account with onboarding completed (your-slug.wooshpayment.com provisioned)

1. Download the plugin

Direct button:

⬇ Download wooshpayment-checkout.zip

The zip is ~5 KB. Contains one PHP file (~120 lines) + readme.txt. Zero external dependencies, no third-party libraries.

2. Upload to WordPress

Step 2.1 — Plugins → Add new

Go to WordPress Admin → Plugins → Add new plugin (link at the top).

Step 2.2 — Upload plugin (don't search)

You'll see two tabs at the top: "Search plugins" and "Upload plugin". Click Upload plugin — do NOT search the marketplace.

Step 2.3 — Choose the file and install

1. Click Choose file → select wooshpayment-checkout.zip (the one you downloaded at step 1)
2. Click Install now

Step 2.4 — Activate the plugin

WP unpacks + installs in ~3 seconds. At the end the Activate plugin button appears — click it.

Step 2.5 — See the plugin in the list

You land on the plugin list with WooshPayment Checkout at the top, green Active status. In the sidebar you'll find a new entry Settings → WooshPayment.

3. Verify it's running

Go to Settings → WooshPayment (new entry in the Settings menu).

The plugin pings our server and shows the live status:

• 🟢 Green "All OK": plugin active, store connected, last checkout intercepted correctly
• 🟡 Yellow: plugin active but no recent checkouts (run a real test)
• 🔴 Red "Not connected": the merchant hasn't completed onboarding on wooshpayment.com (3 steps to fix shown on the page)

If you see green, everything works. ✓

4. Quick test

1. Open your store as a visitor (incognito works)
2. Add a product to the cart → go to /cart/
3. Click Proceed to checkout
4. Expected: you're redirected to your-slug.wooshpayment.com/checkout/... instead of the native WC /checkout/ page
5. The cart is pre-loaded (products, quantities, correct prices)

If you see the branded checkout → all working. You can proceed with a test payment (Whop test card 4242 4242 4242 4242).

What the plugin does (exactly)

• Only on cart and checkout WC pages, enqueues the wc-checkout-interceptor.js script from our CDN
• The script intercepts the click on "Proceed to checkout" and reads the cart via WC Store API (/wp-json/wc/store/v1/cart)
• POST to https://api.wooshpayment.com/api/checkout/create with the cart products
• Receives a branded checkoutUrl and redirects the customer
• Forwards utm_* parameters for Meta/TikTok/Google attribution
• When payment succeeds on Whop, WooshPayment creates the real order on WooCommerce via REST (see next section)

Catalog, orders, inventory — all stay on WooCommerce

The plugin does not replace WooCommerce. Everything stays on WC:

What	Where managed
Product catalog	WooCommerce (admin → Products)
Inventory / stock	WooCommerce
Received orders	WooCommerce (admin → Orders) — created by WooshPayment via API key
Order transactional emails	WooCommerce
SEO plugins (Yoast, RankMath)	WordPress
Catalog theme / design	WordPress / your theme
Only the final checkout	WooshPayment

To automatically create the order on WC after payment, WooshPayment needs a Consumer Key + Consumer Secret from your WC REST API. Generate once following the WC integration guide — the plugin alone isn't enough, because the JS script only handles the button redirect.

Uninstall

1. WordPress Admin → Plugins
2. Find WooshPayment Checkout → click Deactivate
3. (Optional) Click Delete to remove completely

The native WooCommerce checkout returns immediately. No catalog / order row is touched. The plugin doesn't write to the DB.

Updates

For now plugin updates are manual: download a new wooshpayment-checkout.zip, go to Plugins, deactivate the old one, activate the new one.

Roadmap: publication on the official WordPress.org plugin directory for automatic WP updates. Q3 2026.

Troubleshooting

"Upload plugin" is missing — I only see "Add new plugin → Search plugins"

Some WordPress hosts (e.g. WordPress.com Business, some managed plans) have disabled custom plugin upload. If that's your case:

1. Ask the provider to enable upload (usually enterprise tier)
2. Or extract the zip, upload the files via SFTP into /wp-content/plugins/wooshpayment-checkout/
3. Or use the REST API key guide without the plugin

Plugin activated but checkout button isn't intercepted

Open the browser console (Cmd/Ctrl+Shift+I) on your cart page and check:

1. Is there a request to https://api.wooshpayment.com/wc-checkout-interceptor.js? If no → the plugin isn't enqueuing the script. Verify the plugin is active + WooCommerce is active.
2. Does the script return 200? If 403/500 → problem on our side, open a ticket.
3. Console errors? Look for [WooshPayment] messages. Common causes:
   • fetch /wp-json/wc/store/v1/cart fails → WC Store API disabled. Go to WooCommerce → Settings → Advanced → Legacy API and verify REST APIs are enabled.
   • POST /api/checkout/create 401 → your store isn't connected on WooshPayment yet. Complete step 9 of the WC integration guide (Consumer Key + Secret).

Accidentally deactivated the plugin

Reactivate from Plugins → WooshPayment Checkout → Activate. No re-setup needed.

WordPress multisite

The plugin works on WordPress multisite. Must be activated per site that has WooCommerce. Only sites where it's active + WC present will be intercepted.

Next steps

• Complete WooCommerce integration setup — Consumer Key, orders, webhook
• Configure Whop as the processor — required to accept cards on the branded checkout
• Brand the checkout — logo, colors, fonts of your subdomain

---

Questions? Open a ticket or use the chat at the bottom-right of the dashboard.