This document aims to provide guidance on how to test your integration via Billie’s Sandbox environment. We strongly recommend thoroughly testing your Billie integration before going live.

Step 1: Setup your Sandbox access

To test your Billie integration in Sandbox, you first need to create a test account. For Billie integrations, via API, SDK, and Plugins your test credentials will be provided directly by Billie during your onboarding. If you haven’t received your test account yet, you can request one via help.billie.io.

Testing via Klarna Playground:
You can test your Billie integration via Klarna in your Klarna Playground account. To do so, you first need to request Billie Sandbox access for your Klarna Playground account via help.billie.io. Please add your Klarna Playground Merchant ID to your request. (Klarna Playground Merchant IDs usually start with “PK…”) Our customer support team will respond within 2-3 business days. As soon as your Klarna Playground ID is connected to the Billie Sandbox, you will be able to test the end-to-end workflow for order creation.

You don’t have a Klarna Playground account yet? You can sign-up for a test account here.

Step 2: Start testing in Sandbox

There are a couple of things to pay attention to when testing the order creation flow in Sandbox. To ensure all order flows are working correctly we strongly recommend using the test sample data provided in this document.


Sandbox Limitations

Billie will not query any external databases during the order creation in Sandbox. This means that only buyers that were already validated by Billie in the past will be available for identification in the sandbox.\n- Billie’s Sandbox validates the company address when creating an order. If you are using a fake company address you will receive an error.

Testing data: "Approved Order" flow

Use the following data to test the approved order flow.

Company Name Billie GmbH
StreetCharlottenstr. 4
Commercial register numberHRB182428 / HRB182428B / HR182428B / Handelsregister B HR182428

(The format of this number is not standardized - different formats depending on merchant/shop form are valid)
VAT ID NumberDE310295470
Email AddressPlease use a real email address to view the emails you would receive after a successful purchase.


Please note: Only the following commercial register number format: e.g. HRB182428 is supported in Klarna Checkout Integrations (KCO).

Approved Order ScreenApproved Order Screen

Approved Order Screen

Testing Data: “Company Suggestion” flow

You can trial the "Company Suggestion" flow using the same company details as above, but use Barney fun as the company name. Once sent, you will be asked to choose a company that are registered with similar data. If you click “no, try again”, the user will be redirected to the “unrecognized buyer” workflow. (See below)


The Billie algorithms are learning from more and more data, this can also lead to the “Unrecognized Buyer” workflow directly.

Company Suggestion ScreenCompany Suggestion Screen

Company Suggestion Screen

Testing data: “Order Denied” flow

You can trial order denials by using the same company details as above, but modify the email address as follows: [first name].[last name][email protected]. This will result in declined orders based on exceeding credit limits.

Order Denied ScreenOrder Denied Screen

Order Denied Screen

“Unrecognized Buyer” flow

If you are trying a test scenario with an unrecognized buyer and the Billie Widget opens to retrieve buyer data, the fields have to be filled as follows. To trial the "Unrecognized Buyer" flow you can use the address: Chausseestr. 100, 10100 Berlin.


The widget offers “Search-as-you-type” just choose Billie GmbH as the company name and the other fields will be filled automatically

Select Legal FormSelect Legal Form

Select Legal Form

Add Company DetailsAdd Company Details

Add Company Details

Step 3: Acceptance Test

After testing all order flows successfully, you can book an acceptance test with our integration team. Please contact your sales representative or schedule an appointment for your acceptance test via [email protected].