Connect Klarna
Summary
Section titled “Summary”The Klarna tool lets your KonversAI assistant answer a customer’s questions about the Klarna payment for an order in your Shopify store. You add it on the Assistant tools screen in the KonversAI console. Select Settings in the left sidebar, then select AI tools. The tool works together with the Shopify tool. After the customer verifies their email address, the assistant finds the order in Shopify, then reads the payment from Klarna. It tells the customer whether Klarna has approved and the store has charged the order, how much is refunded and when, and whether a refund made in the store has reached Klarna yet. The tool only reads. It never changes an order in Klarna or in Shopify.
Who can do this
Section titled “Who can do this”A team member with the View tools permission opens the Assistant tools screen in the KonversAI console. A team member with the Modify tools permission adds, edits, validates and deletes the tool. A Tenant Admin holds both permissions, always. Without View tools, the item AI tools does not appear under Settings in the left sidebar. Ask a Tenant Admin to grant Modify tools on the User permissions screen. You also need access to the Klarna Merchant portal to create API credentials.
Before you start
Section titled “Before you start”The Klarna tool finds orders through the Shopify tool, so connect Shopify first. See Connect Shopify. The Shopify tool must be enabled in the same workspace. Without it, the Klarna tool cannot look up any payment, and KonversAI shows a warning on the Klarna tool.
Your store must take Klarna payments through its own Klarna merchant account, for example with the Klarna payments app for Shopify. When Klarna is offered through Shopify Payments, your store has no Klarna account of its own. The assistant then answers from the payment and refund records in Shopify only.
Create API credentials in the Klarna Merchant portal, under Settings →
Klarna API keys. You get either an API username with a password, or a
single API key that starts with klarna_live_api_. Note which region your
Klarna account belongs to: Europe, North America or Oceania.
The tool always needs a verified email, because the assistant only looks up the customer’s own orders. Without one, the tool answers No verified email found for this conversation. KonversAI includes the Email Verification tool in every workspace, so you do not add it.
Create API credentials in Klarna
Section titled “Create API credentials in Klarna”- In Klarna: Sign in to the Klarna Merchant portal for the store’s merchant account.
- In Klarna: Open Settings, then Klarna API keys, and create new credentials. Copy the username and password, or the API key, before you close the page.
Add the tool in KonversAI
Section titled “Add the tool in KonversAI”- In KonversAI: Select Settings in the left sidebar, then select AI tools. Select + Add tool.
- In KonversAI: Select Klarna in Tool type. You cannot change the type later.
- In KonversAI: Type a label in Display name, for example
Klarna. KonversAI fills Slug while you type. - In KonversAI: Type your instruction in Usage guidance for the AI assistant, for example Use this when the customer asks about a Klarna payment, invoice or refund for an order.
- In KonversAI: Keep the Enabled checkbox selected.
- In KonversAI: Choose the region of your Klarna account in Klarna region: Europe, North America or Oceania. The default is Europe. Credentials work only in their own region.
- In KonversAI: Keep Environment at Live. Choose Playground (test) only with Klarna test credentials.
- In KonversAI: Leave Klarna order id metafield empty, unless your
store saves the Klarna order id in a Shopify order metafield. Then type it
as
namespace.key, for examplecustom.klarna_order_id. - In KonversAI: Fill in the Secrets card. With a username and password, select Add secret on API username, paste the username, and select Apply. Then do the same on API password or key with the password. With a single API key, leave API username empty and paste the whole key in API password or key.
- In KonversAI: Select Add tool at the bottom. KonversAI saves the tool and opens it again with the heading Edit tool.
- In KonversAI: Select Validate and save. KonversAI makes one call to Klarna and shows the result in a banner. A success banner says, for example, Klarna accepted the API credentials (Europe).
What can the assistant tell a customer about a Klarna payment?
Section titled “What can the assistant tell a customer about a Klarna payment?”The Klarna tool tells the customer the state of the Klarna payment for one of their orders in your Shopify store. The assistant can say whether Klarna has approved the purchase and whether the store has charged it. It can say how much is charged, how much is refunded and on which dates, and how much is not yet charged. It also gives the Klarna reference the customer sees in the Klarna app. The customer can name an order number. Without one, the assistant uses their most recent order. The tool needs a verified email address and an enabled Shopify tool.
Why does the assistant say the customer will not be billed yet?
Section titled “Why does the assistant say the customer will not be billed yet?”With Klarna, the customer is billed for what the store has charged, and a store usually charges an order when the order ships. Until then, Klarna has only approved the purchase. The Klarna tool reports that state, and the assistant explains that the customer pays once the store charges the order. If part of the order has shipped, the store may have charged only that part. The assistant then gives the amount that is not yet charged.
A customer says the store refunded them, but Klarna still shows the full amount. What does the assistant say?
Section titled “A customer says the store refunded them, but Klarna still shows the full amount. What does the assistant say?”The Klarna tool compares the refunds in Shopify with the refunds Klarna shows. When the store has refunded more than Klarna shows, the assistant tells the customer that a refund made in the store normally reaches Klarna shortly afterwards. The customer’s Klarna balance updates then. If the store’s refund is more than a day old and Klarna still does not show it, the assistant offers to hand the conversation over to your team. Check the order in the Klarna Merchant portal.
Why does the assistant answer from Shopify only for some orders?
Section titled “Why does the assistant answer from Shopify only for some orders?”The Klarna tool always reads the payment and refund records in Shopify
first. It adds Klarna’s own record only when it can find the Klarna order that
belongs to the Shopify order. This fails when the order was paid another way,
when Klarna was offered through Shopify Payments, or when the Shopify order
carries no Klarna order id. The assistant then answers from the Shopify
records. If your store saves the Klarna order id in a Shopify order metafield,
type that metafield in Klarna order id metafield on the Klarna tool, as
namespace.key.
Can a customer see someone else’s Klarna payment?
Section titled “Can a customer see someone else’s Klarna payment?”No. The Klarna tool looks up only orders placed with the email address the customer verified in the conversation. It then shows a Klarna order only when Klarna’s record matches that Shopify order, or when Klarna holds the same verified email for it. An order number or a Klarna id that belongs to another customer gives no answer. The assistant never takes a Klarna id from the customer’s message.
Why does the assistant refuse to look up a payment?
Section titled “Why does the assistant refuse to look up a payment?”Most often because the conversation has no verified email address. The Klarna tool answers No verified email found for this conversation. and the assistant asks the customer to verify. KonversAI includes the Email Verification tool in every workspace, so there is nothing to add. The Klarna tool also refuses when no Shopify tool is enabled in the workspace, because the tool finds orders through Shopify. Enable the Shopify tool on the Assistant tools screen.
Validate and save says Klarna rejected the API credentials. What now?
Section titled “Validate and save says Klarna rejected the API credentials. What now?”The banner starts with Klarna rejected the API credentials. Open the Klarna tool in the KonversAI console: select Settings in the left sidebar, then AI tools. Check that Klarna region and Environment match the account the credentials belong to. Then replace API username and API password or key in the Secrets card with credentials copied again from the Klarna Merchant portal. Klarna disables credentials that go unused for a long time, so create new ones if the old ones stopped working. KonversAI never shows a stored secret again, so replace the value rather than trying to read it.
How do I stop the assistant answering payment questions?
Section titled “How do I stop the assistant answering payment questions?”Select the switch beside the Klarna tool. Select Settings in the left sidebar of the KonversAI console, then select AI tools. The switch saves at once, and the word beside it reads Off. The assistant stops seeing the tool at once. Your settings and your credentials stay in place. Select the switch again to bring the tool back. You need the Modify tools permission.
Last reviewed . Tell us when a step no longer matches the product.