# 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


```bash
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.

## Legal information

- 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.