{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-contents/partners/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Switch from Vipps Checkout to Kustom Checkout","description":"Explore our documentation and API and start integrating Kustom Checkout","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"switch-from-vipps-checkout-to-kustom-checkout","__idx":0},"children":["Switch from Vipps Checkout to Kustom Checkout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Wait for your invitation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you're unsure, email ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:support@kustom.co"},"children":["support@kustom.co"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-start","__idx":1},"children":["Before you start"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"check-that-your-setup-is-supported","__idx":2},"children":["Check that your setup is supported"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are using ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Vipps/MobilePay Recurring"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you're unsure whether your current setup is fully supported, contact ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:support@kustom.co"},"children":["support@kustom.co"]}," before making any changes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-happens-to-existing-vipps-orders","__idx":3},"children":["What happens to existing Vipps orders"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keep the Vipps plugin installed"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pre-flight-checklist","__idx":4},"children":["Pre-flight checklist"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Confirm all of the following before starting:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," You have received your Kustom account credentials (check your email, or contact ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:support@kustom.co"},"children":["support@kustom.co"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Your store meets the technical requirements: WordPress 5.0+, WooCommerce 5.6.0+, PHP 7.4+, and HTTPS"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," You have confirmed that all Vipps features you rely on are available in Kustom (see above)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once all boxes are checked, proceed to Step 1."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1--install-kustom-checkout-for-woocommerce","__idx":5},"children":["Step 1 — Install Kustom Checkout for WooCommerce"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Install the Kustom Checkout plugin using one of the following methods:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["From WordPress.org:"]}," Download and upload via your WordPress admin panel — ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://wordpress.org/plugins/kustom-checkout-for-woocommerce/"},"children":["get the plugin →"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["From WooCommerce Marketplace:"]}," Download directly from the WooCommerce marketplace — ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://woocommerce.com/products/kustom-checkout/"},"children":["get the plugin →"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2--retrieve-your-kustom-api-credentials","__idx":6},"children":["Step 2 — Retrieve your Kustom API credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You need API credentials to connect WooCommerce to Kustom. Use the test portal for now — you'll add your live credentials in Step 7."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to the Kustom portal:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Test: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.playground.kustom.co"},"children":["portal.playground.kustom.co"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Live: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.kustom.co"},"children":["portal.kustom.co"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrations → API"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Generate new"]}," (or use existing credentials)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Password"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only users with ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["admin"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3--configure-kustom-checkout","__idx":7},"children":["Step 3 — Configure Kustom Checkout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Activate Kustom Checkout in WooCommerce and point it at your test credentials. Do not switch to live mode yet — test first."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WooCommerce → Settings → Payments → Kustom Checkout → Manage"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enable Kustom Checkout"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enable Test Mode"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Log debug messages"]}," — logs are required if you need to contact support."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Password"]}," in the test credentials section."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save changes"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a full walkthrough of how to configure you Kustom Checkout plugin, please see Krokedils guide ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.krokedil.com/kustom-checkout-for-woocommerce/get-started/"},"children":["here"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4--verify-your-woocommerce-settings","__idx":8},"children":["Step 4 — Verify your WooCommerce settings"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pretty permalinks are enabled"]}," — go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WordPress Settings → Permalinks"]}," and confirm a non-plain option is selected."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Terms and Conditions page is assigned"]}," — go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WooCommerce → Settings → Advanced → Page setup"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Prices display 2 decimals"]}," — go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WooCommerce → Settings → General → Currency options"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cart and checkout pages are not cached"]}," — caching these pages causes checkout failures."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-5--test-the-checkout","__idx":9},"children":["Step 5 — Test the checkout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run a full test purchase before going live."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your store, go through checkout in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Test/Playground mode"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use test data to complete the payment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify that:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The checkout iframe loads correctly"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The payment goes through"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You're redirected to the confirmation page"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The order appears in WooCommerce"]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If something goes wrong, check the logs under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WooCommerce → Status → Logs"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-6--disable-vipps-checkout","__idx":10},"children":["Step 6 — Disable Vipps Checkout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WooCommerce → Settings → Payments"]}," and disable Vipps Checkout."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Do not deactivate or delete the Vipps plugin"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-7--go-live","__idx":11},"children":["Step 7 — Go live"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once your test order confirms everything works, switch to live mode."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to the live portal at ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.kustom.co"},"children":["portal.kustom.co"]}," and retrieve your live API credentials (see Step 2)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WooCommerce → Settings → Payments → Kustom Checkout → Manage"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your live ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Password"]}," in the live credentials section."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Uncheck ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enable Test Mode"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save changes"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Run a real purchase to confirm everything works in production."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.kustom.co"},"children":["portal.kustom.co"]}," and verify the order is visible and the amount matches WooCommerce."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You're done."]}," Kustom Checkout is now live in your store."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"support","__idx":12},"children":["Support"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Topic"},"children":["Topic"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Contact"},"children":["Contact"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Plugin installation and technical questions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://krokedil.com/support/"},"children":["Krokedil support →"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account, transition, or payment questions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:support@kustom.co"},"children":["support@kustom.co"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Open source platform responsibility"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:merchant@kustom.co"},"children":["merchant@kustom.co"]}," before going live."]}]}]},"headings":[{"value":"Switch from Vipps Checkout to Kustom Checkout","id":"switch-from-vipps-checkout-to-kustom-checkout","depth":1},{"value":"Before you start","id":"before-you-start","depth":2},{"value":"Check that your setup is supported","id":"check-that-your-setup-is-supported","depth":3},{"value":"What happens to existing Vipps orders","id":"what-happens-to-existing-vipps-orders","depth":3},{"value":"Pre-flight checklist","id":"pre-flight-checklist","depth":3},{"value":"Step 1 — Install Kustom Checkout for WooCommerce","id":"step-1--install-kustom-checkout-for-woocommerce","depth":2},{"value":"Step 2 — Retrieve your Kustom API credentials","id":"step-2--retrieve-your-kustom-api-credentials","depth":2},{"value":"Step 3 — Configure Kustom Checkout","id":"step-3--configure-kustom-checkout","depth":2},{"value":"Step 4 — Verify your WooCommerce settings","id":"step-4--verify-your-woocommerce-settings","depth":2},{"value":"Step 5 — Test the checkout","id":"step-5--test-the-checkout","depth":2},{"value":"Step 6 — Disable Vipps Checkout","id":"step-6--disable-vipps-checkout","depth":2},{"value":"Step 7 — Go live","id":"step-7--go-live","depth":2},{"value":"Support","id":"support","depth":2}],"frontmatter":{"title":"Switch from Vipps Checkout to Kustom Checkout","description":"A step-by-step guide for WooCommerce merchants migrating from Vipps Checkout to Kustom Checkout.","seo":{"title":"Switch from Vipps Checkout to Kustom Checkout"}},"lastModified":"2026-06-09T07:22:48.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/contents/partners/e-commerce-platforms/woocommerce-vipps-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}