chameleon-system-private/klarna-payments-bundle

8.0.45 2025-12-15 13:57 UTC

README

This bundle integrates Klarna payment methods (direct debit, bank transfer, credit card, pay later, instalments, loan).

Installation

  1. Register the bundle in AppKernel::registerBundles():
new \ChameleonSystem\KlarnaPaymentsBundle\ChameleonSystemKlarnaPaymentsBundle(),
  1. Run:
$ composer require chameleon-system/klarna-payments-bundle "~8.0.0"

(use matching version for your core version)

  1. Run the Chameleon updates.
  2. Add the payment type "Klarna Payments" to your relevant Shipping Cost Groups
  3. Upload an icon for the payment (you may use the icon provided in Resources/public/images/klarna.png)
  4. Configure the icon for the payment in the backend
  5. Go to Klarna Playground and live dashboard and create API credentials
  6. Configure these credentials in the payment configuration of the backend (Payments/Zahlungsanbieter -> Klarna Payments -> Tab: Paymenthandler -> KlarnaPayments -> Config Parameter)
  7. If you want to use "capture on shipment", go to Payments/Zahlungsanbieter -> Klarna Payments -> Tab: System -> Configuration and set the option to "1" (true) Additionaly you should change the description of the payment method to inform the buyer about the late capture
  8. Set environment to development for local testing

API Documentation

https://docs.klarna.com/klarna-payments/integrate-with-klarna-payments/

B2B

If you want to use Klarna with B2B customers, you need an account at https://www.billie.io/ and connect the payment in the Klarna backend.

Open to the Config Parameters in the Chameleon Backend (see Nr. 8 above) and set the b2bActive parameter to "1".

The payment will not be available if the billing address is a b2b address (has company or vat it filled) and the B2B option is not active. Beware! Activation of B2B option without having a contract with Billie will lead to non functioning payment with an "internal error" from the Klarna API.

Styling

It is possible to style the widget colors: https://docs.klarna.com/klarna-payments/in-depth-knowledge/additional-features/

Todos