Klarna Docs - Migrating from current to new payments integration

Migrating from current to new payments integration

Current Shopify merchants will have to migrate their Klarna alternative payment method (HPSDK (Hosted Payment SDK) integration to the new payments integration. (Note: this isn't publicly available yet for Klarna, but is coming soon.)

The steps to migrate are:

  1. Click the "Integration" link in the Klarna Merchant Portal and follow the steps provided to 1) install the unlisted Klarna app in your Shopify store admin, 2) generate & save new Klarna API credentials in the Merchant Portal, 3) verify the new integration in the Merchant Portal, and 4) activate the new Klarna alternative payment method in your Shopify store admin, which will enable 'Klarna' to display as a payment method in your Shopify checkout. (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.)
  2. In Shopify store admin (under Settings -> Payments -> Alternative payment methods), deactivate your current Klarna alternative payment method(s). This will remove the HPSDK Klarna payment methods (e.g. "Buy now, pay later with Klarna") in the store's Shopify checkout. Do not remove the current HPSDK Klarna Payments app OR deactivate the Klarna API credentials used for that integration in your store (at least until all previous HPSDK orders are finalized), as the Klarna Payments app enables your order management updates (i.e. captures, cancels, refunds) from your Shopify admin to automatically update Klarna.
  3. As long as your Klarna contract (and corresponding merchant id) doesn't change, no changes should be needed in the Klarna On-site messaging app when you switch from the Klarna HPSDK integration to the new payments integration.

Do NOT deactivate the Klarna Payments app in your store (as that is used for order management for previously placed orders); only deactivate the Klarna HPSDK alternative payment method(s).

Merchants may migrate from the "SOFORT Banking (DIRECTebanking)" alternative payment method to a similar Sofort payment method by either activating:

  1. "Sofort" as a local payment method (within Shopify Payments) OR
  2. "Klarna" as an alterative payment method (separate from Shopify Payments), which can include the Sofort payment option if activated in the merchant's Klarna contract.

Note: if Klarna is activated in a store as both a local payment method (within Shopify Payments) AND also as an alternative payment method (not within Shopify Payments), only the local payment method will appear as a payment method in Shopify checkout.

The merchant's current Sofort project/contract will not be transferable when migrating to a different payment method.

There is not currently a published date when merchants must migrate off the SOFORT Banking (DIRECTebanking).

example of "SOFORT Banking (DIRECTebanking)" in Shopify checkout