Skip to main content
The Klarna integration lets your team view and respond to Klarna payment disputes without switching to the Klarna Merchant Portal. Chatarmin CX automatically creates a ticket for every new Klarna dispute, and the same dispute also appears in the customer panel of any other ticket for that customer.

​
When to use it

Use Klarna in Chatarmin CX when:
  • customers pay with Klarna and you receive chargebacks, claims, or evidence requests
  • agents need order context and ticket history beside dispute details
  • you want AI Agents to look up disputes, draft evidence, or propose dispute actions with human approval
Chatarmin CX creates one inbox ticket per Klarna dispute automatically.

​
How dispute tickets work

When a dispute is created or updated on a connected Klarna account, cx indexes it and — if it has a buyer email and doesn’t already have a ticket — creates one automatically:
  • Channel — the ticket lands on your Klarna channel, separate from your other conversations.
  • Contact — cx finds or creates a contact using the buyer’s email address.
  • Subject — the ticket subject follows the pattern Klarna dispute — {reason} — {amount}.
  • Tags — the ticket is tagged dispute and klarna so you can build views, routing rules, or AI Agent triggers around it.
  • Status — the ticket opens as open, or resolved if the dispute was already closed when it first synced. When Klarna later marks the dispute resolved, cx updates the ticket to resolved automatically.
A dispute with no buyer email doesn’t get a ticket yet — cx creates one as soon as an email is available (see the tip below about Shopify). The dispute keeps appearing in the customer panel of any other ticket from the same contact too, so agents see dispute history alongside every conversation, not only on the dedicated dispute ticket.

​
Set it up

You need Klarna Disputes API credentials (API username and password) for each merchant account you connect. Your Klarna account must be enabled for dispute management.
1

Open integrations

Go to Integrations and select Klarna.
2

Connect a merchant account

Click Connect, enter a display name (optional), and add your Klarna API username and password. You can connect multiple Klarna accounts per workspace — for example, one per storefront or region.
3

Test the connection

After saving, use Test connection on the account card to confirm credentials work.
When you connect, Chatarmin CX automatically registers dispute webhooks for your account — you do not need to configure webhooks yourself. Automatic setup only works when Klarna has already enabled webhook access for your merchant account. If your account does not have that access yet, ask your Klarna contact to enable it, then reconnect or edit the integration.
If automatic webhook registration is unavailable for your account, the integration dialog may show Webhook setup required with manual fields. That path is only for merchants Klarna has not yet granted webhook API access.
Connecting Shopify helps Chatarmin CX match disputes to customers when Klarna does not include a buyer email. Link the customer’s email on the contact when disputes — or their dispute ticket — do not appear.

​
Use Klarna disputes in the inbox

Every Klarna dispute has its own ticket in your Klarna channel, and the same dispute also surfaces in the customer panel of any other ticket for that contact.
1

Open the dispute ticket or a related ticket

Open the dispute’s ticket in your Klarna channel, or any other ticket whose contact shares the buyer’s email address.
2

Confirm the contact email

The contact needs an email address. If none is set, add one — disputes and their tickets are matched by email.
3

Review disputes

In Disputes, open a Klarna row to see reason, stage, amount, response deadline, activity, order references, and evidence requests.
4

Respond

Use the action form at the bottom of the dispute detail sheet. Available actions depend on the dispute stage.

​
Actions you can take

Klarna does not support in-dispute messaging, settlement offers, or escalation actions that PayPal provides. Use Send reply on the ticket to communicate with the customer separately.

​
Evidence file rules

When Klarna asks for proof:
  • upload PDF only
  • maximum 7 MB per file
  • up to 10 files per submission
  • add a short description for each file
Some dispute reasons ask extra questions — for example whether the order shipped, tracking details, or whether a return was received. The form shows only the fields Klarna requires for that case.

​
AI Agent actions

Give a dispute-handling AI Agent Klarna actions so it can work inside the ticket:
1

Connect Klarna

Complete the integration setup above.
2

Enable actions on the agent

In AI Agents, open the agent and enable the Klarna actions the job needs. Select which connected Klarna account(s) the agent may use.
3

Set approvals

Keep Accept Klarna dispute claim on Always require approval. Partial refund proposals on Provide evidence also pause for approval before they run.
4

Add instructions

Tell the agent to call Get Klarna dispute before any write, use order data from Shopify or your fulfillment integration for tracking fields, and use Send reply for customer-facing updates — not Klarna dispute messaging.
You can also trigger agents when a new or updated dispute is indexed. Use the Dispute indexed trigger and filter by provider Klarna and statuses such as Needs your response.

​
Best practices

  • Set up a view or routing rule for your Klarna channel so new dispute tickets reach the right queue automatically.
  • Resolve disputes before the response due date shown in the detail sheet.
  • Keep the contact email aligned with the Klarna order’s billing email so disputes and their tickets appear correctly.
  • Gather PDF proof (invoice, delivery confirmation, return policy) before opening Provide evidence.
  • Use a clear display name when you connect multiple Klarna accounts so agents pick the right one.
  • For sensitive financial actions, require human approval on the AI Agent even when the default is optional.

​
Troubleshooting