This guide will help you to integrate with Laybuy by Klarna using Laybuy APIs.

If your e-commerce store previously integrated with Laybuy through the direct integration (LAYBUYAPI), re-enabling that integration with Laybuy by Klarna is a straightforward process.

Prerequisites:

Before starting, make sure you have:

Successfully onboarded as a Merchant and access to the Merchant portal dashboard.
A previously working Laybuy integration OR the necessary access to your e-commerce store’s backend to implement the integration changes.

Merchant Onboarding

There are two ways to onboard with Klarna as a Merchant

1. Airwallex

Klarna has partnered with Airwallex, a leading global payment provider, for a smooth merchant onboarding experience.

More information here: https://www.airwallex.com/nz/laybuy-by-klarna

2. Klarna

You may be onboarded directly by Klarna by our Merchant onbarding team.

More information here: https://www.klarna.com/international/enterprise/

Steps to Integrate with Laybuy by Klarna

Onboard with Laybuy by Klarna as a Merchant - either with our PSP partner Airwallex Or with Klarna directly.
Request for the playground merchant account for testing - either from Airwallex team or Klarna
Access the Merchant portal and generate API credentials.
Follow the API guide to integrate your e-commerce platform with Laybuy by Klarna.
- See Order API docs here.
- See the Basic API integration flow here.
If you had a previous Laybuy integration, review the API changelog here.
Add Laybuy by Klarna branding to your store and at checkout page.
- Add Price breakdown / Product display page (PDP) to your store.
- Add a ‘Pay by Laybuy by Klarna’ at checkout page.
- See Branding Guidelines here.
Engage with the merchant onboarding team for end-to-end testing of your integration in staging environment and then promote to production.

Setting Up a Klarna Playground Merchant Account for Testing:

Note: This guide applies only if your merchant account is set up directly with Klarna (not via our PSP partner, Airwallex).

Klarna provides a Playground environment for testing merchant integrations in a non-production/sandbox environment. Full documentation is available here:

https://docs.klarna.com/resources/developer-tools/testing-payments/before-you-test/

Below is a quick summary for setting up a Playground merchant account for the Test environment:

Create a 'playground' merchant account for the 'Australia' region by following this guide - Creating a new test account , or go to this link directly for signup: https://js.playground.klarna.com/mjolnir/das-gui/playground/ap/index.html
Once an account is created, login to the playground merchant portal: https://portal.playground.klarna.com/
In merchant portal, generate API credentials by going to: Settings -> Klarna API keys -> Generate new API keys
Use the playground API credentials in your testing environment for the Laybuy sandbox API endpoint: https://sandbox-api.laybuy.com
You can grant playground merchant portal access to your teammates via going to User Manager.