Adding Scalapay to WooCommerce
WooCommerce runs on your own WordPress install, which makes setup straightforward but puts hosting, caching and plugin conflicts in your hands rather than ours.
Getting live on WooCommerce
The order below matters — messaging before testing, testing before live traffic.
Install the plugin
Add the Scalapay plugin through your WordPress admin and activate it.
Enter your credentials
Paste the API keys from your merchant dashboard into the plugin settings.
Enable the gateway
Turn Scalapay on in the WooCommerce payments tab so it appears at checkout.
Show the installment message
Add the message to product and cart templates using the provided block or shortcode.
Six things specific to WooCommerce
The details that cause support tickets if you skip them.
Caching plugins
Aggressive page caching can serve a stale checkout. Exclude cart and checkout pages from caching, which is standard practice anyway.
Plugin conflicts
Checkout-modifying plugins are the most common cause of problems. Test after installing or updating any of them.
Keep it updated
Because you control the stack, plugin and WooCommerce updates are on your schedule. Test the checkout after each one.
Refunds
Refund through the WooCommerce order screen. We reconcile and adjust the customer plan. How refunds work →
Order limits
Orders run from $200 to $5,000, and you can set a tighter range in the plugin settings.
Block-based checkout
If you use the newer block checkout, confirm the gateway renders correctly there as well as on the classic template.
Test the paths that are not the happy one
Every integration works when the customer does exactly the expected thing. Problems come from the other cases.
- A customer who abandons at the approval step — they must land somewhere sensible with the basket intact.
- A declined order — this is a normal outcome, not an error. Send them back to a checkout with other options available.
- A partial refund — check the customer plan recalculates and your own reporting matches.
- An order outside the range — validate against $200 to $5,000 before showing the option, so nobody is offered something that will fail.
Testing only the successful order is the most common reason an integration causes problems in its first week.
WooCommerce integration FAQ
What developers and store owners ask before starting.
Is there a WooCommerce plugin for Scalapay?+
Do I need a developer?+
Why is Scalapay not appearing at checkout?+
Can I test before going live?+
How do refunds work?+
Does it work with the block-based checkout?+
Other integrations
Same account, different platform.
Ready to add it?
Apply for a merchant account and we will get you the credentials and the docs.