# Setup

## Profile Configuration

Click **Settings > Plugins > Ratepay Profile Configuration**

![](/assets/setup1.4c27c2e34fe30cc901ac028c30b6cc01b21eb77a66fe9ca6b8fa6284e078f002.14d779f6.png)

Enter the API credentials you got from Ratepay and assign them to your corresponding **Sales Channel**.
If you have no individual credentials so far, use our global test credentials:

| Profile ID | Security Code |
|  --- | --- |
| `INTEGRATION_TE_DACH_OPT` | `LZuRV3fDp5dIeQ9pxFGN2lgQ85FS9WZi` |
| `INTEGRATION_TE_DACH_OPT_0RT` | `Bsz8cKW5NqiGedRFb5h4IGXNOIFQOa0j` |


These test credentials are valid for all available countries. Individual credentials normally differ from country to country and from frontend to backend. Backend credentials are required for [admin orders](/docs/developer/shop_modules/shopware/shopware_6/daily_business/admin_orders).

If you are using test credentials you have to enable the **Test-Mode Option**.

After saving the provided credentials all available Ratepay payment methods for this account are shown like in the image below. Reload the information by pressing the **Reload config** button. If you changed the credentials before, please **Save** before reloading the configuration.

![](/assets/setup2.0e4140a4ad2923985277fb559b6a7b44f46bb2d392435e1a839ce8af2fc7684c.14d779f6.png)

## Module Configuration

Click **Settings > Extensions > My extensions > Ratepay Payment Plugin for Shopware 6 > Configuration**

![](/assets/setup3.ae100d4666f9d447b9bd10b22eb0d7127192fb3cd7aad97f239bbf0bbed3b87b.14d779f6.png)

### Bi-directionality

By enabling bi-directionality, Ratepay will get updates if the status of an order changed. It doesn't matter if you do the update manually by using the order detail view in Shopware or if it's send by external systems, such as ERPs and middlewares.

**Activate this feature as follows:**

1. Set **Auto-deliver/cancel/refund of order-items based on delivery status** to **active**.
2. You also have the possibility to update the **payment** and/or **delivery** status on deliver/cancel/refund order-item


![](/assets/setup4.164977f3858f89c4421feda7e3333bdfe5216c13a7e2f3509b8600f8c0933274.14d779f6.png)

Order changes done in external systems, such as ERP systems, will now automatically sent to Ratepay if the uses the Shopware state machine functionality for deliveries (c.f. [Shopware documentation](https://developer.shopware.com/docs/concepts/commerce/checkout-concept/orders)).

### Customizable payment states

Payment states can be customized for each single payment method. Predefined states will be automatically set to an order after successful checkout.

![](/assets/setup5.a469099b06a5482e0ffcfa101c72209ca429ea4507df3642ea1454712e957f8c.14d779f6.png)

### Device fingerprinting

The **Snippet ID** is an individual key and you get it when [registering for the services of Ratepay](https://www.ratepay.com/en/contact/).

![](/assets/setup6.5e6e2ce8c502615dbdbbbba91c0f056c5d47612fc898fcb991683a82fd7cf587.14d779f6.png)

### Advanced settings

![](/assets/setup7.7b1bc4bc6c26831b8b6a1840edf701bfe702ad6c0b90eb2dc1d70a3ec95df8fa.14d779f6.png)

#### Handling of additional address lines

Only applicable if 2 or more street lines are configured. With this option you are able to control which additional address line is submitted to Ratepay as additional address field.

#### Handle shipping costs and vouchers as basket items

Ratepay's payment gateway can handle shipping costs and discounts in two different ways. Depending on the Ratepay API version you are using in your backend system (like an ERP), you may need to modify that settings.

**Default = No**

Starting with Ratepay API version 1.8, shipping costs and discounts are submitted in a special `<shipping>` element or `<discount>` element.


```xml
<shopping-basket> with <shipping>-element

<shopping-basket amount="13.89" currency="EUR">
    <items>
        <item article-number="12345" quantity="1" tax-rate="19" unit-price-gross="9.99">Testproduct</item>
    </items>
    <shipping tax-rate="19" unit-price-gross="5.9">Shipping costs</shipping>
    <discount tax-rate="19" unit-price-gross="-2">Voucher</discount>
</shopping-basket>
```

**Basket item = Yes**

For older API versions set this option to Yes. Then shipping costs and discounts will be handled like other line items.


```xml
<shopping-basket> with line-items only

<shopping-basket amount="13.89" currency="EUR">
    <items>
        <item article-number="12345" quantity="1" tax-rate="19" unit-price-gross="9.99">Testproduct</item>
        <item article-number="Discount" quantity="1" tax-rate="19" unit-price-gross="-2">Voucher</item>
        <item article-number="Shipping" quantity="1" tax-rate="19" unit-price-gross="5.9">Shipping costs</item>
    </items>
</shopping-basket>
```

This setting should only be used, if an external system cannot handle the <shipping>-element. Misconfiguration will result into rejected operations.

#### Disable auto-delivery of virtual products

By default virtual products will be auto captured. Here you have the option to disable that behavior.

#### Feature Flags

Feature Flags are mentioned on our [Github documentation](https://github.com/ratepay/shopware6-module?tab=readme-ov-file#feature-flags) and should only be used if advised.

### Instalment information on product page

With this option you can add an indication of the estimated instalment amount and runtime for the configured Ratepay instalment or 0% financing product.
The calculation is done based on the maximum available runtime and under consideration of the unit article price.

![](/assets/setup8.8e21a8aab90b0f6c9052af45c6fe75e86ecba51f6d6102f2a3ff425f23657706.14d779f6.png)

![](/assets/setup9.136f45be6b5ebe84ade0eb171bc6a863531f67d616b12177b8bf38518571a366.14d779f6.png)