This guide walks you through replacing the Vipps Checkout plugin on WooCommerce with Kustom Checkout. Vipps remains available as a payment method inside Kustom — your customers won't notice a disruption. The change is on your side: a new plugin, a new portal, and new API credentials.
Wait for your invitation
Only proceed if you have received an onboarding email from Kustom. If you haven't received one yet, do not start the switch — you'll be contacted when it's your turn.
If you're unsure, email support@kustom.co.
If you are using Vipps/MobilePay Recurring or Vipps Express Checkout, your migration will be handled separately. Do not proceed with this guide just yet — Kustom will contact you directly when your transfer is ready.
If you're unsure whether your current setup is fully supported, contact support@kustom.co before making any changes.
Orders placed through Vipps Checkout before the switch continue to be managed through the Vipps portal and Vipps API. You will disable Vipps Checkout as a payment method during the steps below, but you must keep the plugin installed — this preserves your order history and references in WooCommerce.
Keep the Vipps plugin installed
Do not deactivate or delete the Vipps/MobilePay for WooCommerce plugin. Doing so may break order management for existing Vipps orders, including captures, refunds, and cancellations. Only disable it as a payment method so it no longer appears at checkout.
Confirm all of the following before starting:
- You have received your Kustom account credentials (check your email, or contact support@kustom.co)
- Your store meets the technical requirements: WordPress 5.0+, WooCommerce 5.6.0+, PHP 7.4+, and HTTPS
- You have confirmed that all Vipps features you rely on are available in Kustom (see above)
Once all boxes are checked, proceed to Step 1.
Install the Kustom Checkout plugin using one of the following methods:
- From WordPress.org: Download and upload via your WordPress admin panel — get the plugin →
- From WooCommerce Marketplace: Download directly from the WooCommerce marketplace — get the plugin →
Optional: Order management functionality is included in the plugin from version 2.19.0 or higher. If you have an older version, install the separate Klarna Order Management plugin to capture, refund, and manage orders directly from WooCommerce.
You need API credentials to connect WooCommerce to Kustom. Use the test portal for now — you'll add your live credentials in Step 7.
- Log in to the Kustom portal:
- Test: portal.playground.kustom.co
- Live: portal.kustom.co
- Navigate to Integrations → API.
- Click Generate new (or use existing credentials).
- Copy your Key ID and Password.
Only users with admin or super-admin roles can access the Integrations tab. If you don't see it, ask your account owner to retrieve the credentials or grant you the right role.
Activate Kustom Checkout in WooCommerce and point it at your test credentials. Do not switch to live mode yet — test first.
- Go to WooCommerce → Settings → Payments → Kustom Checkout → Manage.
- Check Enable Kustom Checkout.
- Check Enable Test Mode.
- Check Log debug messages — logs are required if you need to contact support.
- Enter your Key ID and Password in the test credentials section.
- Click Save changes.
For a full walkthrough of how to configure you Kustom Checkout plugin, please see Krokedils guide here
- Pretty permalinks are enabled — go to WordPress Settings → Permalinks and confirm a non-plain option is selected.
- Terms and Conditions page is assigned — go to WooCommerce → Settings → Advanced → Page setup.
- Prices display 2 decimals — go to WooCommerce → Settings → General → Currency options.
- Cart and checkout pages are not cached — caching these pages causes checkout failures.
Run a full test purchase before going live.
- In your store, go through checkout in Test/Playground mode.
- Use test data to complete the payment.
- Verify that:
- The checkout iframe loads correctly
- The payment goes through
- You're redirected to the confirmation page
- The order appears in WooCommerce
If something goes wrong, check the logs under WooCommerce → Status → Logs.
Once Kustom Checkout is working correctly in test mode, disable Vipps Checkout as a payment method so it no longer appears in your store's checkout.
- Go to WooCommerce → Settings → Payments and disable Vipps Checkout.
Do not deactivate or delete the Vipps plugin
Keep the Vipps/MobilePay for WooCommerce plugin installed and active. Deactivating or deleting it may break order management (captures, refunds, cancellations) for orders placed before the switch.
Once your test order confirms everything works, switch to live mode.
- Log in to the live portal at portal.kustom.co and retrieve your live API credentials (see Step 2).
- Go to WooCommerce → Settings → Payments → Kustom Checkout → Manage.
- Enter your live Key ID and Password in the live credentials section.
- Uncheck Enable Test Mode.
- Click Save changes.
- Run a real purchase to confirm everything works in production.
- Log in to portal.kustom.co and verify the order is visible and the amount matches WooCommerce.
You're done. Kustom Checkout is now live in your store.
| Topic | Contact |
|---|---|
| Plugin installation and technical questions | Krokedil support → |
| Account, transition, or payment questions | support@kustom.co |
Open source platform responsibility
When running Kustom Checkout on an open source platform, you are responsible for ensuring your configuration, platform version, and any third-party code are supported. Contact merchant@kustom.co before going live.