Klarna

Setting Up Klarna for FoxyCart

Klarna offer a few different integration types. Foxy's integration uses the Klarna Payments account type, which Klarna may also refer to as One Klarna/Klarna One - so you will need to ensure you have that account type when integrating with Foxy. If you're not sure what account type you have with Klarna, we'd recommend reaching out to the Klarna support team to confirm.

To connect Klarna to your Foxy store, follow these steps:

1. 1

   Log in to your Klarna account portal

2. 2

   From the dashboard, select “Settings”. This should take you to the “API Credentials” section, but if not, click that in the left hand navigation.

3. 3

   Click the “Generate new API credentials” button. If you already have existing API credentials for your account, you'll be asked to confirm you want to create new ones.

4. 4

   A window will be displayed with your new API credentials. Copy these to a text file on your computer temporarily - especially the “Password” as this is the only time you'll have access to this value.

5. 5

   Log in to your store's Foxy administration and head to the “Payments” section

6. 6

   Ensure the payment servers are switched to “Live Servers” at the top of the page.

7. 7

   Enable “Accept payments using your Klarna Payments account”, and enter the API credentials you just copied into the respective fields. Make sure you also select the correct region for your store in the “merchant account continent” dropdown.

8. 8

   Save your payment settings.

At this time, Klarna has been activated for your store!

Klarna payment options are presented to the customer based on the currency of the cart and their location. Here's an example of options presented for a Norwegian customer:

Using EMD (Extra Merchant Data)

If you're selling specific product types, Klarna may require that you pass in Extra Merchant Data, as outlined in their docs: https://docs.klarna.com/klarna-checkout/popular-use-cases/extra-merchant-data/

Foxy currently supports the “event” EMD, which must be passed in as a product-specific value with the product option name of klarna_emd_event and a JSON value. In a link (unsigned), it might look like this:

<a href="https://foxy-demo.foxycart.com/cart?name=Prod1&price=5&code=sku1&klarna_emd_event=%7B%22event_company%22%3A%22Executive%20Education%20-%20Business%20Analytics%20Program%22%2C%22start_time%22%3A%222021-11-01T09%3A00%3A00Z%22%2C%22end_time%22%3A%222022-02-01T09%3A00%3A00Z%22%7D">
  Add to Cart
</a>

The value of the klarna_emd_event is URL encoded JSON that looks like this:

{
  "event_company": "Executive Education - Business Analytics Program",
  "start_time": "2021-11-01T09:00:00Z",
  "end_time": "2022-02-01T09:00:00Z"
}

(Note that you don't technically need to URL encode the JSON, but it is required if you use the HMAC signing functionality, and since most people and systems use double-quotes to wrap the href value, you will actually need to URL encode it.)

You'll also need to set the klarna_emd_event product option to hidden, in your store's template configuration, under the “Customize Cart Display” section. That will prevent the value from displaying to your customers on the cart.

Testing

Obtaining A Test Account

Follow the notes on the Klarna documentation for creating a test account: https://docs.klarna.com/resources/test-environment/

Test Card Numbers

Contact klarna for info.

Troubleshooting & Interpreting Response Codes

Contact klarna for info.

Important Notes and Caveats

• Our Klarna integration does not support subscriptions at this time.

• Klarna only support specific locales and currencies in specific countries. For example, for a customer in the US Klarna only supports en_US and USD, in Germany they support de-DE and en-DE with a currency of EUR. More details here.