WooCommerce integration

The WooCommerce integration uses the official REST API. It works with WordPress 6.0+ and WooCommerce 8.0+. The store must be on HTTPS.

1. Generate the API keys in WooCommerce

1. WordPress Admin → WooCommerce → Settings → Advanced → REST API
2. "Add key"
3. Description: WooshPayment
4. Permissions: Read/Write
5. Save — copy Consumer Key and Consumer Secret (shown only once)

2. Connect on WooshPayment

1. Dashboard → Settings → E-commerce platform → choose WooCommerce
2. "WooCommerce connection" section → fill in:
   • Store URL: e.g. https://my-store.com (no trailing slash)
   • Consumer Key: paste
   • Consumer Secret: paste
3. Save → WooshPayment pings /wp-json/wc/v3/products?per_page=1 to validate the keys

Credentials are encrypted at rest (AES-256-GCM).

3. Checkout button redirect

Unlike Shopify (where we install the ScriptTag automatically), WooCommerce does not expose an equivalent API to inject JS into the storefront. You have two options:

A) WordPress plugin (recommended) ⚡ — Our official plugin replaces the "Proceed to checkout" button with a redirect to {slug}.wooshpayment.com. 2 minutes, zero code. → See plugin install guide

B) Manual snippet in the theme — If you can't install plugins on your WordPress, add this snippet to your child theme's functions.php (or via a Code Snippets plugin):

add_action('wp_footer', function() {
  $slug = 'YOUR-SLUG'; // replace with your WooshPayment slug
  if (!is_checkout() && !is_cart()) return;
  echo "<script>
    document.addEventListener('DOMContentLoaded', function() {
      var btns = document.querySelectorAll('.checkout-button, .wc-proceed-to-checkout a, button[name=\"woocommerce_checkout_place_order\"]');
      btns.forEach(function(b) {
        b.addEventListener('click', function(e) {
          e.preventDefault();
          fetch('https://api.wooshpayment.com/api/checkout/create', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({
              shop: location.hostname,
              cartToken: '',
              items: window.wcCart || [],
              totalPrice: 0,
              currency: 'EUR'
            })
          }).then(r => r.json()).then(d => { if (d.checkoutUrl) location.href = d.checkoutUrl; });
        });
      });
    });
  </script>";
});

The items payload here is simplified; see API reference for the full version that maps line items + variants.

4. Verify

1. Open the store in incognito
2. Add a product → go to the cart
3. Click "Proceed to checkout"
4. You must land on {your-slug}.wooshpayment.com/checkout/...
5. Complete a test payment
6. Verify the order in WooCommerce → Orders with status Processing

Order sync

On confirmed payment we call POST /wp-json/wc/v3/orders:

• Default status: processing (configurable)
• Order notes: Paid via WooshPayment (session: ch_xxx)
• payment_method: woopay (or cod for cash on delivery)
• Customer email: sent by WooCommerce with its own templates

Compatibility

Frequent issues

"401 Unauthorized" after connect

• Check that the site is HTTPS — we don't connect to HTTP
• Reopen WooCommerce → REST API and verify the key hasn't been revoked
• Verify that the permission is "Read/Write" (not just "Read")

Different prices between WooCommerce and WooshPayment

Often a VAT issue. WooshPayment respects WooCommerce's display_prices_including_tax. Check in WooCommerce → Settings → General → Taxes.

"Invalid cart" on the customer side

Prices changed between add-to-cart and checkout. The customer should refresh the cart and try again.

Next steps

• Whop payments setup
• Checkout branding
• Transactional emails