> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tilta.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopware 6 plugin

> Install and configure the Tilta payment plugin for Shopware 6.4–6.6. Offer buyers deferred payment terms directly in your Shopware storefront.

The Tilta Shopware 6 plugin adds Tilta's buy-now-pay-later payment method directly to your Shopware storefront. Once installed and configured, your business buyers can apply for a credit facility and choose deferred payment terms at checkout – without leaving your store. The plugin handles authentication, order creation, and invoice capture automatically in the background.

<Note>
  The Tilta plugin is **not available on the Shopware App Store**. You must install it manually via Composer or by uploading the release ZIP file through the Shopware Extensions manager.
</Note>

## Supported versions

The plugin is tested and supported on the following Shopware releases:

| Shopware version | Supported |
| ---------------- | --------- |
| 6.4.X            | ✅         |
| 6.5.X            | ✅         |
| 6.6.X            | ✅         |

## Prerequisites

Before you install the plugin, make sure you have:

* A registered Tilta account with API credentials
* At least **one enabled merchant** configured in the Tilta Portal
* Shopware 6.4, 6.5, or 6.6 installed with administrative access
* Composer available on your server (for Composer-based installation)

If you do not have API credentials yet, contact [support@tilta.io](mailto:support@tilta.io) to request sandbox access.

## Installation

<Tabs>
  <Tab title="Composer (recommended)">
    Installing via Composer keeps the plugin under version control and makes future updates straightforward.

    <Steps>
      <Step title="Require the package">
        Run the following command in your Shopware root directory to add the plugin to your project:

        ```shell theme={null}
        composer require tilta/shopware6-payment-module
        ```
      </Step>

      <Step title="Refresh the plugin list">
        Tell Shopware to detect the newly installed plugin:

        ```shell theme={null}
        ./bin/console plugin:refresh
        ```
      </Step>

      <Step title="Install and activate the plugin">
        Install and activate the plugin in a single command:

        ```shell theme={null}
        ./bin/console plugin:install TiltaPaymentSW6 --activate
        ```

        After this command completes, the Tilta payment method is available in your Shopware administration panel.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Manual (ZIP upload)">
    Use this approach if you do not have Composer on your server or prefer to manage plugin files directly.

    <Steps>
      <Step title="Download the release ZIP">
        Go to the [Tilta Shopware 6 Plugin releases page](https://github.com/tilta-io/tilta-shopware-6-plugin/releases) on GitHub. Download the file named `TiltaPaymentSW6-x.x.x.zip` for the latest stable release.
      </Step>

      <Step title="Upload the plugin to Shopware">
        In the Shopware administration panel, navigate to **Extensions → My Extensions**. Click the **Upload Extension** button and select the ZIP file you downloaded.
      </Step>

      <Step title="Activate the plugin">
        After uploading, find **TiltaPaymentSW6** in the extensions list and toggle it to **Active**. Shopware will run the plugin's installation routines automatically.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Updating the plugin

<Tabs>
  <Tab title="Composer">
    To update to the latest compatible version, run:

    ```shell theme={null}
    composer require tilta/shopware6-payment-module
    ./bin/console plugin:update TiltaPaymentSW6
    ```

    Composer resolves and downloads the newest release, and the `plugin:update` command runs any pending database migrations.
  </Tab>

  <Tab title="Manual">
    Download the latest `TiltaPaymentSW6-x.x.x.zip` from the [GitHub releases page](https://github.com/tilta-io/tilta-shopware-6-plugin/releases) and repeat the ZIP upload steps. Shopware will detect the newer version and run any required migrations automatically.
  </Tab>
</Tabs>

## Configuration

After installation, configure the plugin with your Tilta API credentials and adjust the settings for your storefront.

<Steps>
  <Step title="Open the plugin configuration">
    In the Shopware administration panel, go to **Extensions → My Extensions**. Find **TiltaPaymentSW6** in the list, click the **three-dot menu** (⋮) next to it, and select **Configure**.
  </Step>

  <Step title="Enter your API credentials">
    Select the environment you want to configure (**Sandbox** or **Production**) and paste the corresponding API key from the Tilta Portal into the **API Key** field.
  </Step>

  <Step title="Test your credentials">
    Click the **Test credentials** button. Shopware sends a test request to the Tilta API and displays a success or error message. Do not proceed until this test passes.
  </Step>

  <Step title="Map custom salutations">
    If your store uses custom salutation options, scroll to the salutation mapping section and map each custom value to either **Mrs.** or **Mr.**. Tilta requires one of these two standard values during buyer onboarding.
  </Step>

  <Step title="Enable state change notifications">
    Toggle **Notification about state changes** to enabled. This setting allows Tilta to push payment and credit status updates back to your Shopware orders in real time.

    <Tip>
      Enabling state change notifications is strongly recommended. Without it, order statuses in Shopware may not reflect the actual payment state in Tilta.
    </Tip>
  </Step>

  <Step title="Save and publish the payment method">
    Click **Save** to apply your configuration. Then navigate to **Sales Channels → \[Your Sales Channel] → Payment & Shipping** and add **Tilta – Pay Later** to the list of active payment methods. Your buyers can now select Tilta at checkout.
  </Step>
</Steps>

## Further resources

<CardGroup cols={2}>
  <Card title="GitHub repository" icon="folder-git-2" href="https://github.com/tilta-io/tilta-shopware-6-plugin">
    Browse the plugin source code, report issues, and read the repository README for advanced configuration options.
  </Card>

  <Card title="PHP SDK" icon="file-code" href="/docs/integration-php-sdk">
    If you need to extend or customise the plugin, the underlying PHP SDK gives you direct access to all Tilta API endpoints.
  </Card>

  <Card title="API reference" icon="book" href="/api-reference">
    Explore the full REST API documentation that the plugin uses under the hood.
  </Card>

  <Card title="Contact support" icon="mail" href="mailto:support@tilta.io">
    Reach out to the Tilta team if you encounter issues during installation or configuration.
  </Card>
</CardGroup>