Klarna Docs - Installing the new Klarna payments integration for Shopify

Installing the new Klarna payments integration for Shopify

In order to go live with Klarna Payments on Shopify, you need to be able to login into the Klarna Merchant Portal. If you don’t yet have a Klarna merchant account, you can sign up at http://klarna.com/business

We recommend first log into both your Shopify store admin (as a the full account owner) and the Klarna merchant portal. Please make sure to select the correct store to associate to the desired Klarna merchant ID, as once associated in Klarna's database, it takes 48 hours after uninstalling the Klarna app, or a manual update by Klarna, to remove the association; once a store is associated to a merchant ID, that merchant ID will be blocked from use for another store. Each Shopify store must have its own unique Klarna merchant ID; merchant IDs cannot be shared across stores.

Once the below steps are started, we recommend you complete the steps at minimum through step #4 to avoid a partial entry in Klarna's database, which results an integration that would error. Step #5 (activate, or deactivate, the payment method) can be done multiple times, whenever desired, without breaking the integration.

  1. Start: Click the "Integration Guides" link in the Klarna Merchant Portal and click the 'Shopify' option. (If you don't have the "Integration Guides" option displaying for your account, email skosm@klarna.com and we will enable it for you.)
  2. Install app: Since only the full store account owner can install Shopify payments apps and activate payment methods in their store, make sure you are logged into your Shopify store as the store account owner. Click the "Install Klarna Shopify Application" button. (Note: while this app is a public app, it is not listed in the Shopify app store, and will NOT be displayed in your store's 'Apps' menu like other apps, which is expected for Shopify new payments apps).
  3. Connect: Generate & connect new Klarna API credentials. As directed, for security purposes, download these API credentials to your local computer, even though you won't enter these credentials anywhere for this new payments integration flow, as that is done automatically for you.
  4. Test: the integration is verified.
  5. Activate: activate the new, single alternative payment method, named "Klarna", in your Shopify store admin (which is only permissible as the full account owner of the store). (There may be other payment methods supporting Klarna available to activate, such as Paymentwall, pay.nl, etc., but those other payment methods require different credentials and different corresponding payments apps to work successfully. Activating a payment options other than the one named only "Klarna" will result in an error upon redirect from Shopify checkout without appropriate credentials.) When the appropriate "Klarna" payment method is activated, "Klarna" will display as a payment method in your Shopify checkout, per screenshot below.
  6. Verify: first add a product to your cart. Go through your Shopify checkout, select the new Klarna payment method in your store's checkout payment page, and after clicking the “Pay Now” or "Complete" button (or after the Review Order page, if configured for your store), simply make sure the Klarna hosted payment page loads successfully. Placing a test order as fees is not necessary, and be aware that fees could apply if the payment method isn't in "test mode".

    (Note: initially, only the production merchant portal will be supported for test mode of the payment method; a production merchant account will be required even for test mode orders.)

Klarna is now live in your Shopify store!

Check out the video below to see the new installation in action.

We recommend that both email and phone number should be configured in your Shopify admin as required in your store's checkout.

Step #1: Start

Step #3: Connect

Note: You can't continue past this step until you "Generate and connect credentials" and save the newly generated API credentials.

Step #4: Test

Step #5: Activate

(This step will take you to your Shopify store to activate the payment method in your store's checkout.)

Activating the payment method in your store enables Klarna to display in checkout. Make sure to verify that Klarna loads successfully though as this step does no validation if the integration was completed successfully,

  1. Is the "Klarna" new payments app installed in your store? By design by Shopify, new payments apps aren't displayed under a store's "Apps" menu. To verify you have the app installed in your store, go to Shopify admin -> Settings -> Payments. Look for the "Klarna" payment method. If the payment method is active in your store, it will be included in the displayed list of active payment methods for your store and you can view the details of the payment method by clicking the "Manage" link. If the button says "Uninstall Klarna", the app is currently installed in your store. (Note: payments apps can only be uninstalled from a store when the payment method is deactivated.) If the payment method is NOT active in your store, you will have to search for it (by payment methods OR by provider), click "Activate" which will take you to the payment methods details, where if the app is already installed in your store, you'll have the option to click another green "Activate Klarna" button within the payment method to activate the payment method in your store's checkout. If you are shown an "About Klarna" page with a green "Connect" button, the app is NOT currently installed in your store.
  2. Note: the "Klarna" payment method (aka gateway) is NOT the same as the "Klarna" app. New payment app integrations requires an app, and the payment method and the app work together for a successful integration. Deactivating or activating the "Klarna" payment method impacts the storefront's checkout (if the Klarna payment method displays or not), but the payment method displaying in checkout does not impact if the integration works successfully (and does not update Klarna's database). Uninstalling or installing the app does impact the integration, so please be careful to only uninstall the Klarna app when necessary.
  3. Did you previously complete the integration through Integration Guides step #4 (Test), and then uninstall the "Klarna" app? If so, you'll need to wait 48 hours or request Klarna to do a manual database update (via skosm@klarna.com) to be able to redo the integration.
  4. Does the "Klarna" payment method say "You are connected to Klarna but you can’t use it to accept payments because your account is still being approved ...." - No need to wait for approval. See Known Constraint #6 to complete the integration in Klarna's Merchant Portal -> Integration Guides.
  5. Is your store configured in Klarna's database? If you've confirmed that the app is installed in your store, to next verify the database connection, log into the Klarna Merchant Portal, select "Integration Guides" from the left menu and select the "Shopify" option. If that page goes to directly Step #4 ("Test"), your store has an entry in the database already. If that page doesn't load, or loads with an error, see: Known Constraints #5 If the page loads at any other step, please complete the Integration Guides flow to get a valid entry in our database. Note: even though you will generate a set of API credentials during this Integration Guides flow, you will not enter those credentials anywhere in your Shopify store, as the code does it for you.
  6. Does the "Klarna" payment method display in your store's checkout? If not, make sure the Klarna payment method is active in your store admin, under Settings -> Payments. If the payment method is active, but doesn't display, check for custom script code in the Script Editor app (which is only supported by Shopify for live stores that are Shopify Plus) or custom CSS code that might change the display of your store's checkout. If there is no custom code, contact Shopify for support.
  7. If the payment method errors when used (upon redirect from Shopify to Klarna's hosted payment page): "Your payment can’t be processed for technical reasons. Try again or use a different payment method.", see: Known Constraints #6
  8. The Klarna page loads after redirect, but no payment methods are available or order is rejected: Your Shopify integration was successful, but no payment methods are available for the entered consumer data for your Klarna merchant account. Make sure to enter valid consumer data, not dummy test data. Make sure your store's single base currency matches your Klarna account configuration, see Known Constraints #1
  9. Need help? We're happy to help; click here for info about contacting our support team.

    Note: deactivating or activating the payment method in your store only controls the display of the payment method in your store's checkout; that step does not impact the integration working successfully.