ALBIS Leasing manual.

How to connect ALBIS Leasing to your Shopware shop - from credentials through the checkout application to status syncing.

Video

A tour of the setup, the product page and the checkout, recorded right in the Shopware admin and the shop.

ALBIS leasing for Shopware

1 / 1

Watch the video on its own page

Requirements

Shopware 6.7 and an existing dealer contract with ALBIS. There is a separate plugin version for Shopware 6.5 and 6.6 each. Without a contract and credentials the plugin cannot retrieve leasing offers. The payment method is available from a cart of 500 euros net.

Some context: ALBIS Leasing connects your shop to an external leasing provider. Credit checks, contracts and payouts sit with ALBIS, not with the shop.

Installation

Upload the plugin through the plugin manager, install and activate it, then open the configuration and enter the credentials. The configuration also adapts to the dark mode of the administration.

Storing credentials

Username and password
The credentials from your dealer contract, provided by ALBIS.
Test & save
Saves the configuration, checks the connection and, if successful, loads the product groups without reloading the page. If the test fails, “Credentials are not correct” appears.
Product group
Only groups that belong to the credentials are listed. Choose the group from your ALBIS account, otherwise ALBIS rejects the application. The list is cached, the button next to the select reloads it.
Active interface
The configuration shows whether the live or the test interface of ALBIS is in use. You no longer enter the address yourself.

If you run several sales channels, you can store separate credentials for each, see Credentials per sales channel.

Credentials per sales channel

If you have several sales channels, for example a second shop, another language or a B2B portal, you can store separate ALBIS credentials for each channel. This is needed when the channels run on different ALBIS dealer contracts.

  1. Select the sales channel at the top of the plugin configuration.
  2. Enter username, password and product group for this channel, and the details for contract 2 if needed.
  3. Click „Test & save“. Connection test, product groups and the active interface display refer to the selected channel.
  4. Repeat for further channels.

Without a selected channel, the values apply to all sales channels. Fields you leave empty in a channel take over these values automatically, so you only enter what differs.

From these versions: Credentials per sales channel are available in all three plugin lines: from 2.6.40 for Shopware 6.7, from 2.3.14 for Shopware 6.6 and from 2.2.2 for Shopware 6.5. Older versions use one setting for all channels.

Sandbox mode

For trying things out without real applications. With the mode active, the plugin talks to the ALBIS test interface, and the minimum order value of 500 euros net is dropped so that small test orders can be run through.

Important: For test orders via the sandbox, the amounts sent to ALBIS do not match the actual cart, so that ALBIS calculates rates despite small sums. Switch the mode off again before going live.

Two contracts in parallel

Besides the main credentials, a second username, a second password and a second product group can be stored, also per sales channel. This is meant for dealers holding two ALBIS contracts, for example with different terms or for different legal entities.

Which contract applies to an item is set on the product: if the custom field custom_albis_contract has the value 2, rate and application use contract 2, otherwise contract 1.

Commission

Commission is given as a percentage, with allowed values between 0 and 5. The default is 5 percent. It feeds into the calculation of the leasing rates.

Managing director details

Whether the form also asks for the owner's or managing director's details depends on the selected legal form. For sole proprietors and partnerships, such as e.K., freelancers, GbR, trade businesses or partnership companies, the section appears automatically: salutation, name, date of birth, address, phone and email. For all other legal forms these details are neither checked nor sent to ALBIS.

Display on the product page

Enabled by default. From a price of 500 euros net, the product detail page shows a block headed „Leasing made simple" with a button that opens a rate example with term, monthly rate and insurance. It is based on the calculated price, including advanced prices, tier prices and price rules. The setting can be switched off if leasing should only appear during checkout. Rates are cached for 24 hours, so the page stays fast and ALBIS is not asked on every page view. The note block takes on the font and colours of your theme, dark themes included. On smartphones the block is kept compact. The button has no URL of its own, so search engines do not get a page per product with almost identical content. Old requests to such addresses are answered with 410 so search engines drop them from the index (from 2.6.45, 2.3.18 and 2.2.6). More on the display on the product page

Application confirmation copy

After every leasing application the customer receives a confirmation by email. Optionally another address can receive this confirmation in BCC. Useful when leasing cases are handled separately in-house. The template lives in the Shopware mail settings and can be adjusted there. More on the plugin emails

Status coupling

With coupling enabled, the Shopware order status is updated automatically from the ALBIS leasing status. It is off by default, leaving the order status under your control. Regardless of this: if the leasing application fails at ALBIS, the plugin cancels the order automatically and sets the payment to “Failed” (from 2.6.46, 2.3.19 and 2.2.7).

The leasing application

The application is filled in as a form attached to the order. It asks for the lessee's company details including company name, legal form, street and house number, phone, email and IBAN. Depending on the legal form, the owner's or managing director's details are added. Phone number, IBAN and postcode are checked while filling in the form. The company name must contain at least three letters or digits, the managing director's first and last name at least three letters each. Entries consisting only of special characters are rejected (from 2.6.47, 2.3.20 and 2.2.8).

Special leasing payment

Alongside the leasing model, customers can enter a special payment. The permitted range is displayed, and „recalculate leasing rate" updates the rates.

A common stumbling block: If the special payment entered exceeds the permitted amount, the form rejects it. The message appears directly at the field.

Term and leasing rate

Available terms are shown in months with the matching rate, optionally including a down payment. All amounts are net, excluding VAT. Without selecting a rate the application cannot be submitted.

Submitting the application

„Submit leasing application" sends the application to ALBIS together with the order. The customer receives a confirmation email with all application details, addressed according to the billing address. If a copy address is stored, the confirmation also goes there.

Application number, application details and the status history are shown on the order in the custom field “ALBIS leasing application”.

Checking status from the console

The plugin queries the status of applications at ALBIS through a console command. It has to run regularly via cron job, otherwise the status stays unchanged. A call every 5 minutes is recommended:

*/5 * * * * cd /path/to/shop && bin/console albis:check-status

The command only checks an application when it is due: every 5 minutes in the first half hour, then hourly up to 4.5 hours, then daily up to 90 days. Once a final status is reached, checking stops for that application. After 90 days a last check takes place, and with the status “settled” the order is completed.

Every status change is added with its date to the history on the order. With status coupling enabled, the plugin sets order, payment and delivery to cancelled on rejection or cancellation and completes the order after settlement. With --dry-run you see what would happen without changing anything.

Troubleshooting

No leasing rates are shown

There is no offer for this order. Common causes are a cart below 500 euros net, items not eligible for leasing, a wrong product group or a temporarily unreachable interface.

The IBAN is rejected

The form checks the IBAN while it is filled in, including the check digit. If it is invalid, the message appears directly at the field, and the application can only be submitted with a valid IBAN.

Missing managing director details

For legal forms with managing director details, day, month and year of birth are mandatory. If one is missing, the form will not submit.

The status is not updated

Usually the cron job for bin/console albis:check-status is not running. Run the command once by hand and check the output, then set up the cron job as described under Checking status from the console.

The connection test says “Credentials are not correct”

Enter user name and password exactly as ALBIS sent them, without spaces at the start or end. Check which sales channel you are testing for, and whether the sandbox mode matches your credentials. After a rejection the plugin pauses further requests to ALBIS for 15 minutes.

New product groups or terms do not appear right away

Rates and product groups are cached for up to 24 hours. Reload new product groups in the configuration with the button next to the select.

The payment method does not appear on the product page

Check the detail page display setting and whether the payment method is active in the sales channel.

Support

We are happy to answer questions about the setup inside your shop. Questions about terms, credit decisions and contracts go directly to ALBIS. Get in touch via the contact page or write to info@stoneandwater.online.

Obtaining the plugin

ALBIS Leasing is free to download, with its own version for Shopware 6.5, 6.6 and 6.7. For Shopware 6.6 and 6.7 the right version including updates also comes through the free Plugin Suite. Using it requires a dealer contract with ALBIS, and terms and credentials come from there.

Offering leasing in your shop?

Back to ALBIS Leasing.

Every feature and the download are on the product page. We are happy to help with setup and credentials.