API Reference
API Reference
Start typing to search…

Getting Started

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:

  1. Successfully onboarded as a Merchant and access to the Merchant portal dashboard.
  2. 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

  1. Onboard with Laybuy by Klarna as a Merchant - either with our PSP partner Airwallex Or with Klarna directly.
  2. Request for the playground merchant account for testing - either from Airwallex team or Klarna
  3. Access the Merchant portal and generate API credentials.
  4. Follow the API guide to integrate your e-commerce platform with Laybuy by Klarna.
  5. If you had a previous Laybuy integration, review the API changelog here.
  6. 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.
  7. 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:

  1. 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
  2. Once an account is created, login to the playground merchant portal: https://portal.playground.klarna.com/
  3. In merchant portal, generate API credentials by going to: Settings -> Klarna API keys -> Generate new API keys
  4. Use the playground API credentials in your testing environment for the Laybuy sandbox API endpoint: https://sandbox-api.laybuy.com
  5. You can grant playground merchant portal access to your teammates via going to User Manager.