<!-- canonical: https://docs.costplus.io/docs/plugins/shopware -->

> Integrate Cost+ with your Shopware 6 store using the official payment plugin
<div style={{background: 'white', borderRadius: '8px', padding: '1rem', display: 'inline-block', marginBottom: '1rem'}}>
  <img src="/images/logos/shopware.png" alt="Shopware" style={{height: '48px', width: 'auto'}} />
</div>

Integrate Cost+ as a payment method in your Shopware 6 store. The official **NoPayn Payment** plugin supports multiple payment methods per sales channel and uses the Hosted Payment Page flow — fully PCI DSS compliant.

## Prerequisites

- Active Cost+ merchant account
- Shopware 6.7 or later
- PHP 8.2 or later
- SSH or terminal access to your Shopware server

## Supported Payment Methods

| Checkout Name | Technical Name | NoPayn Identifier |
|---|---|---|
| Credit / Debit Card | `nopayn_credit_card` | `credit-card` |
| Apple Pay | `nopayn_apple_pay` | `apple-pay` |
| Google Pay | `nopayn_google_pay` | `google-pay` |
| Vipps MobilePay | `nopayn_vipps_mobilepay` | `vipps-mobilepay` |

Each method can be enabled or disabled per sales channel from the plugin configuration.

## 1. Install the Plugin

Clone or copy the plugin into your Shopware `custom/plugins/` directory:

```bash
cd /path/to/shopware/custom/plugins
git clone git@github.com:NoPayn/shopware.git NoPaynPayment
```

Then install and activate via the Shopware CLI:

```bash
bin/console plugin:refresh
bin/console plugin:install NoPaynPayment --activate
bin/console cache:clear
```

## 2. Configure the Plugin

1. In your Shopware admin, go to **Settings → Extensions → NoPayn Payment**
2. Enter your **API Key** from the [Merchant Portal](https://dashboard.costplus.io/) — navigate to **Websites**, click on the website you want to connect, then click **Integration** to find your API key
3. Toggle individual **payment methods** on or off
4. Save

![Cost+ Merchant Portal showing API key](/images/plugins/shared/merchant-portal-api-key.png)

> [!TIP]
> You can configure a different API key per sales channel if you operate multiple storefronts.

> [!WARNING]
> Only activate the payment methods you have been approved for and received confirmation for.

## 3. Payment Flow

1. Customer selects a payment method at checkout and places the order
2. The order is created with transaction status **in_progress**
3. Customer is redirected to the NoPayn Hosted Payment Page
4. After payment:
   - **Success** — customer returns, status is verified via API, transaction set to **paid**, order set to **processing**
   - **Cancelled** — customer returns, transaction and order set to **cancelled**
   - **Expired** (5-minute timeout) — webhook fires, transaction and order set to **cancelled**

## 4. Order Status Mapping

| NoPayn Status | Transaction State | Order State |
|---|---|---|
| `new` | in_progress | open |
| `processing` | in_progress | open |
| `completed` | paid | in_progress |
| `cancelled` | cancelled | cancelled |
| `expired` | cancelled | cancelled |
| `error` | cancelled | cancelled |

## 5. Webhooks

The plugin automatically registers a webhook endpoint at `/api/nopayn/webhook`. This URL is sent to NoPayn when creating orders, providing asynchronous status confirmation for all transactions.

> [!NOTE]
> No manual webhook configuration is required — the plugin handles registration automatically.

## 6. Test and Launch

Place a few test transactions to ensure everything works smoothly. We recommend testing both successful and failed payments to confirm all scenarios are handled correctly.

## Support

Need help? Reach out to our support team at **support@costplus.io**.