Klarna Payment Gateway (Buy now Pay Later) by Codeupp For Europe Region, North America Region, OC Re

# Klarna Payment Gateway Plugin for Botble CMS

**Buy Now, Pay Later — Split purchases into 3 interest-free installments with Klarna.**


---

## About

Klarna Buy Now Pay Later payment gateway integration for Botble CMS. Allows customers to split their purchases into 3 interest-free installments. The #1 BNPL service in Europe with 150M+ users. Compatible with **Martfury**, **Shofy**, **Nest**, and **Farmart** themes.

**Version:** 1.0.0

**Minimum Core Version:** 7.3.0

**Requires:**`botble/payment`

**Markets:** Europe (EU), USA (NA), Australia (OC)

## Supported Countries

🌍 **Europe (EU Region)**

* United Kingdom (UK) 🇬🇧 — Huge market for Klarna

* Germany 🇩🇪

* Sweden 🇸🇪

* Norway 🇳🇴

* Finland 🇫🇮

* Denmark 🇩🇰

* Netherlands 🇳🇱

* Austria 🇦🇹

* Switzerland 🇨🇭

* Belgium 🇧🇪

* France 🇫🇷

* Italy 🇮🇹

* Spain 🇪🇸

* Poland 🇵🇱

* Ireland 🇮🇪

🌎 **North America (NA Region)**

* United States (USA) 🇺🇸 — Huge market

* Canada 🇨🇦

🌏 **Oceania (OC Region)**

* Australia 🇦🇺

* New Zealand 🇳🇿

---

## Developed By

**Maryam International LLC**

- 🌐 Website: [www.codeupp.xyz](https://www.codeupp.xyz)

- 📧 Email: maryaminternationalllc@gmail.com

- 📱 WhatsApp: [+971553682656](https://wa.me/971553682656)

---

## Features

-**Pay in 3 Installments** — Customers split into 3 interest-free payments automatically

-**Product Detail Widget** — Dynamic installment price display on product pages (price ÷ 3)

-**Checkout Integration** — Klarna payment method at checkout with redirect to Klarna HPP

-**Hosted Payment Page** — Klarna's secure hosted checkout page handles the entire payment UI

-**Webhook Support** — Handles Klarna server-side payment confirmation events

-**Refund Support** — Process full or partial refunds directly from Botble admin panel

-**Multi-Region** — EU (Europe), NA (North America), OC (Oceania)

-**Multi-Currency** — EUR, USD, GBP, SEK, NOK, DKK, and more

-**Sandbox / Live Toggle** — Easy switch between Playground (Test) and Production in admin settings

-**Works on Martfury, Shofy, Nest & Farmart** — Compatible with all major Botble CMS themes

---

## Installation

1. Copy the `KlarnaByCodeupp` folder to `platform/plugins/klarna` in your Botble CMS installation

2. Go to **Admin Panel → Plugins** and activate **Klarna Payment Gateway by Codeupp**

3. Run `php artisan vendor:publish --tag=cms-public --force` via SSH

4. Run `php artisan optimize:clear` via SSH

5. Go to **Admin Panel → Payments → Settings** and configure Klarna

---

## Configuration

In the admin payment settings, fill in the following fields:

| Field | Description |

|-------|-------------|

| **API Username** | Your Klarna API Username (UID) from Merchant Portal |

| **API Password** | Your Klarna API Password from Merchant Portal |

| **Region** | 🇪🇺 EU (Europe) / 🇺🇸 NA (North America) / 🇦🇺 OC (Oceania) |

| **Mode** | 🟡 Test Mode (Playground) or 🟢 Live Mode (Production) |

### Where to Get API Credentials

1. Go to [merchant.klarna.com](https://merchant.klarna.com)

2. Log in to your Klarna Merchant Portal

3. Go to **Settings → API Credentials**

4. Generate or copy your **API Username** and **API Password**

### Klarna API Endpoints

| Mode | Region | API URL |

|------|--------|---------|

| Playground (Test) | EU | `https://api.playground.klarna.com` |

| Playground (Test) | NA | `https://api-na.playground.klarna.com` |

| Playground (Test) | OC | `https://api-oc.playground.klarna.com` |

| Production | EU | `https://api.klarna.com` |

| Production | NA | `https://api-na.klarna.com` |

| Production | OC | `https://api-oc.klarna.com` |

---

## Sandbox / Testing

1. Set **Mode** to **🟡 Test Mode (Playground)** in admin settings

2. Get sandbox credentials from [docs.klarna.com/resources/test-environment/](https://docs.klarna.com/resources/test-environment/)

3. Place a test order and select **Klarna** at checkout

4. You will be redirected to Klarna's playground checkout page

5. Complete the test payment using Klarna's test data

6. Order will be marked as **Completed** in Botble

---

## Plugin Structure

```

KlarnaByCodeupp/

├── helpers/

│ └── constants.php

├── plugin.json

├── public/

│ └── images/

│ └── klarna.svg

├── resources/

│ └── views/

│ ├── detail.blade.php

│ ├── instructions.blade.php

│ ├── methods.blade.php

│ └── partials/

│ └── product-detail-klarna.blade.php

├── routes/

│ └── web.php

├── README.md

└── src/

├── Forms/

│ └── KlarnaPaymentMethodForm.php

├── Http/

│ └── Controllers/

│ └── KlarnaController.php

├── Plugin.php

├── Providers/

│ ├── HookServiceProvider.php

│ └── KlarnaServiceProvider.php

└── Services/

├── Abstracts/

│ └── KlarnaPaymentAbstract.php

└── Gateways/

└── KlarnaPaymentService.php

```

---

## Routes

| Method | URL | Description |

|--------|-----|-------------|

| GET | `/payment/klarna/callback` | Customer return from Klarna HPP |

| POST | `/payment/klarna/webhook` | Klarna server-side webhook events |

> Webhook route is excluded from CSRF verification automatically.

---

## Payment Flow

1. Customer selects **Klarna** at checkout

2. Plugin creates a Hosted Payment Page (HPP) session via Klarna API

3. Customer is redirected to Klarna's secure checkout page

4. Customer chooses installment plan and completes identity verification

5. On approval, Klarna redirects back to the callback URL

6. Plugin captures the payment via Klarna Order Management API

7. Order is marked as **Completed** in Botble

8. Klarna also sends a server-side webhook for double confirmation

---

## Refunds

Refunds are processed directly from the Botble admin order detail page:

1. Go to **Admin → Orders → Order Detail**

2. Click **Refund**

3. Enter the amount and reason

4. The plugin automatically calls Klarna's refund API

---

## Developer Documentation

-**Klarna Main Docs:** https://docs.klarna.com/

-**HPP Integration:** https://docs.klarna.com/hpp/

-**API Reference:** https://docs.klarna.com/api/

-**Sandbox Setup:** https://docs.klarna.com/resources/test-environment/

-**Order Management API:** https://docs.klarna.com/api/ordermanagement/

---

## Support

For any issues or questions regarding this plugin:

**Maryam International LLC**

🌐 [www.codeupp.xyz](https://www.codeupp.xyz)

📧 maryaminternationalllc@gmail.com

📱 WhatsApp: [+971553682656](https://wa.me/971553682656)

---

## License

Proprietary — Developed by Maryam International LLC. All rights reserved.