# Get started with Kustom Checkout for Prestashop

Kustom Checkout is a modular, all-in-one checkout solution built for merchants who want to drive conversions and keep shoppers in flow. This **PrestaShop** plugin gives you a seamless, embedded checkout experience - no redirects, no drop-offs.

### Kustom Checkout is Now Live

The **Kustom Checkout** module is available for download and installation:

- **Prestashop Addons Marketplace**:
[Kustom Checkout – Prestashop Addons](https://addons.prestashop.com/en/payment-card-wallet/96437-kustom-checkout-official.html?search_query_id=24e846ec545ca718d40d43f243f033d0&search_index=Products_EN_relevance)
- **Your Prestashop Back Office**:
Search for **"Kustom Checkout"** in the Module Manager and install it directly.


---


### What to do if I'm an existing user?

The **Klarna Checkout** module is no longer maintained and now redirects to the Kustom Checkout product page.

To ensure a smooth transition:

1. Download and install the **Kustom Checkout** module.
2. Verify your credentials and configuration settings.
3. Deactivate any previous version of the Klarna Checkout module.
4. Test the setup in your development environment before deploying it in production.


### Need Assistance?

- **Technical Support**: support@invertus.eu
- **Kustom Account Support**: support@kustom.co


## Module Requirements / Versions Compatibility

- **PrestaShop version:** 1.7.2.x – 9
- **PHP version:** 7.1.x – Latest compatible with PrestaShop 8
- **Note:** Two decimal places are required


## 1. Install the Kustom Checkout Module

### Option A: Using PrestaShop Modules Manager

1. Log into your **Back Office**.
2. Navigate to **Modules → Modules Manager**.
3. Click **Upload a Module**.
4. Drag and drop the `kustomcheckoutofficial.zip` file.


### Option B: Using FTP

1. Download `kustomcheckoutofficial` and extract it.
2. Upload the `kustomcheckoutofficial` folder to your `/modules` directory using an FTP client like [FileZilla](https://filezilla-project.org/).
3. Log in to your PrestaShop **Back Office**.
4. Navigate to **Modules → Modules Catalog**.
5. Search for **Kustom** and click **Install**.


### Locate the Module Later

To access the module settings after installation:

- Go to **Modules → Module Manager**
- Search for **"Kustom"**
- Click **Configure**


## 2. Configure the Module

### Environment Selection

- Two checkboxes allow toggling between **Sandbox** and **Production** mode.
- **Production** is selected by default.


### API Credentials

In Kustom Portal you are able to generate API-credentials. Enter your Kustom **API Username** and **Password** for selected environment

- [Kustom Playground Portal](https://portal.playground.kustom.co/)
- [Kustom Portal](https://portal.kustom.co/)


### Debug Mode

- Enable to view full logs (recommended only for troubleshooting).


## 3. Map Order Statuses

Customize how Kustom statuses map to PrestaShop:

| Kustom State | Default PrestaShop Status |
|  --- | --- |
| New orders | Payment accepted |
| Captured orders | Shipped |
| Canceled orders | Canceled |
| Refunded orders | Refunded |
| Partially captured orders | Partially captured |


## 4. Capture Payments

### Automatically

1. Enable **Capture upon fulfillment**.
2. Select the order status (e.g. "Shipped").
3. Click **Save**.


### Manually

1. Go to **Orders → Orders** in the admin panel.
2. View a Kustom order.
3. Click **Capture Payment** or **Cancel Order**.


## 5. Handle Refunds and Partial Actions

### Refunds

- Refund button appears after a capture.


### Partial Capture

- Click **Capture Order**, select individual items or amount.


### Partial Refund

- Works the same as above from the **Manage Kustom Order** section.


## 6. Customize Styling (Optional)

- Modify styling of checkout if your Kustom account supports it.


## 7. Review Logs

### Detailed Logs

Includes:

- Request
- Response
- Context
- Correlation ID


## 8. Enable Automatic Status Sync (Optional)

- Toggle **Allow automatic order status change**:
  - Enabled: Kustom status updates PrestaShop
  - Disabled: Only initial status is used


## 9. Support

- **Kustom Account Issues:** [support@kustom.co](mailto:support@kustom.co)
- **Module Support:** [support@invertus.eu](mailto:support@invertus.eu)