Skip to content
Last updated

Get started with Kustom Checkout for Magento/Adobe Commerce

Introduction

Kustom Checkout is a modular, all-in-one checkout solution for Adobe Commerce (Magento). It delivers a seamless, embedded checkout experience with support for all Kustom payment methods, B2B purchases, and flexible design customization options.

With a single integration, merchants can offer all Kustom payment methods across supported markets while benefiting from a fast, embedded checkout that keeps shoppers in flow - no redirects or drop-offs.

Key highlights

  • Full payment method coverage across all Kustom-supported countries
  • Pre-filled addresses for a one-click checkout experience
  • Custom checkboxes for marketing and account creation
  • B2B support (business-to-business purchases)
  • Shipping assistant integration
  • Extra Merchant Data (EMD) for better risk assessment
  • Merchant references for settlement reconciliation
  • Flexible design options to match your store's theme

Requirements

  • Adobe Commerce 2.4 (on-prem and cloud) or Magento Open Source 2.4
  • PHP 8.1, 8.2, or 8.4 (Adobe certified versions)
  • HTTPS (SSL certificate installed)
  • Active Kustom merchant account with API credentials

Compatibility

  • Adobe Commerce (cloud) 2.4
  • Adobe Commerce (on-prem) 2.4
  • Magento Open Source 2.4

Step-by-step guide

Installation options

Option 1: Marketplace

  1. Go to your Adobe Commerce Admin.
  2. Navigate to System -> Web Setup Wizard -> Extension Manager.
  3. Locate "Kustom Checkout" and click "Install".
  4. Run readiness check and confirm installation.

Option 2: Composer

composer require kustom/module-checkout
bin/magento setup:upgrade
bin/magento cache:flush

Configuration

In Admin: Stores -> Configuration -> Sales -> Payment Methods -> Kustom Checkout.

Available settings include

  • Enable Kustom Checkout
  • Merchant ID and Shared Secret (credentials)
  • Test mode / Live mode
  • Payment methods (per market)

Supported markets

Kustom Checkout is available in 229 countries, with the following considered core markets: SE, NO, FI, DK, GB, DE, NL, AT, CH, US, ES, FR, BE, PL.

QA verification steps

  1. Install the extension and enable "Kustom Checkout" under Stores -> Configuration -> Sales -> Payment Methods.
  2. Set API Mode = Playground and enter credentials provided for testing.
  3. Save, then go to System -> Cache Management and click "Flush Magento Cache".
  4. Add a product to the cart -> proceed to checkout.

Expected result: Checkout loads successfully with Kustom payment methods visible; no console errors.

Troubleshooting

"The region is not supported" or "Checkout has failed to load."

  • Ensure Base Currency, Store Country, and Merchant Region all match.
  • Check API Mode = Playground and that credentials are active.
  • Flush Magento Cache and retry.

Checkout page not loading at all

  • Confirm the module is enabled in Admin.
  • Clear static content cache and re-deploy if needed.
  • Check browser console for CSP (Content Security Policy) violations.

Payment visible but order not completing

  • Verify webhook or callback URL is accessible.
  • Confirm correct merchant account and API keys.

Support

Technical support: support@kustom.co

When contacting support

Please include the following information in your email, along with screenshots and any relevant attachments.

Email checklist

  • Short summary:
  • Merchant name and Merchant ID:
  • Store URL:
  • Environment: (Production / Staging / Development)
  • Platform version: (e.g., Magento 2.4.6, PHP 8.1)
  • Payment module version: (e.g., Klarna x.x.x or Kustom x.x.x)
  • Date & time of issue: (Preferably in ISO 8601 UTC format)
  • Order ID(s) / Transaction ID(s) affected:
  • Steps to reproduce: 1. 2. 3.

Attachments

  • Screenshots
  • Magento error log files: system.log, exception.log, klarna.log
  • Magento database logs: export table klarna_logs
  • Any recent changes: (e.g., site update, module upgrade, config change)

Security note

Do not attach full card numbers or CVV. Mask all card PANs (e.g., ************4242) and API keys before sending.

  • License: Apache License 2.0
  • Privacy Policy: https://kustom.co/privacy
  • Terms of Use: https://kustom.co/terms

Changelog

  • Version 1.0.0 (October 2025) - Initial release of Kustom Checkout for Adobe Commerce.