Integrate Klarna’s Dispute API V3 to streamline dispute management, minimize financial impact, and protect customer relationships.
A "dispute" occurs when a customer questions a payment due to issues like not receiving goods, unauthorized transactions, or dissatisfaction with a product. Efficiently managing disputes through Klarna’s Dispute API allows Partners/Merchants to respond in a structured manner, minimize financial impact, and resolve issues promptly.
Acquiring Partners who present disputes within a dashboard are required to integrate Klarna dispute handling, such that the friction of dispute handling for Klarna does not differ from other payment methods. By following these guidelines, Partners/Merchants can protect their finances and keep strong relationships with customers. Efficiently resolving disputes reduces chargebacks and builds customer loyalty.
Alternate dispute solution
For Acquiring Partners without a dispute handling flow or Partner-facing dashboard, direct provisioning of Klarna’s Partner Portal may be given to Partners, allowing direct management of disputes.
Integration of Disputes webhooks by the Acquiring Partner is still recommended in these cases, to ensure the Acquiring Partner has visibility on risk factors and outstanding dispute cases.
A dispute typically progresses through several states from initiation to resolution. Understanding these states is crucial for effectively managing disputes:
State | Trigger | Webhook | Expected action | Dispute state duration |
---|---|---|---|---|
Pre-arbitration | A customer initiates a dispute. | payment.dispute.state-change.pre-arbitration – Provides the Partner/Merchant with essential information about the dispute. | Klarna alerts the Partner/Merchant with initial dispute details through a payment.dispute.state-change.pre-arbitration webhook. Partners should review the dispute specifics and prepare any initial response or can accept loss at this stage in order to avoid dispute fees since Klarna will not charge the dispute fee at this stage. | The duration a dispute remains in its initial state varies based on the type of dispute. Immediate transition to arbitration pending: Disputes categorized as High Risk Purchase and Unauthorized Purchase will transition immediately to the next state, which is Arbitration Pending.21-Day minimum duration: Disputes related to the following categories will remain in the initial state for a minimum of 21 days before transitioning to Arbitration Pending:
|
Merchant Evidence Pending | Klarna formally requests evidence from the Partner/Merchant. | payment.dispute.state-change.merchant-evidence-pending – Prompts the Partner/Merchant to provide requested documentation. | Partners/Merchants must upload and submit specific evidence via the Dispute API. Attach the attachment ID received after upload in response to the payment.dispute.state-change.merchant-evidence-pending webhook. | Partners/Merchants are given 14 days to respond to an evidence request. The dispute will remain in this state until evidence is submitted or the window for evidence submission expires. |
Closed | The dispute reaches a resolution. | payment.dispute.state-change.closed – Confirms that the dispute has been finalized and indicates the outcome. | If the dispute closes in favor of the customer, the Partner/Merchant may incur a chargeback. If the Partner/Merchant prevails, no additional action is required. |
Disputes can arise in various situations during a payment transaction. Below are some scenarios to illustrate different pathways to resolve disputes. A dispute is considered resolved once:
Example 1: Products not received
payment.dispute.state-change.pre-arbitration
Example 2: Products faulty
payment.dispute.state-change.pre-arbitration
Example 3: Capture amount incorrect
payment.dispute.state-change.pre-arbitration
Example 4: Purchase unauthorized
payment.dispute.state-change.pre-arbitration
Example 5: Return not refunded
payment.dispute.state-change.pre-arbitration
In certain situations, it may be more practical for a partner/merchant to accept a loss rather than contest a dispute. Accepting a loss means acknowledging that the customer’s claim is valid and agreeing to resolve the dispute by issuing a refund or replacement without further investigation. This approach can save time and resources, especially when the evidence strongly supports the customer or when the cost of defending the dispute outweighs the potential loss.
Consider accepting a loss in the following scenarios:
Accepting a loss can have several implications:
The process for accepting a loss typically involves the following steps:
Example
FashionFusion, an online store, receives a dispute from Karen, a customer claiming that the handbag she received was damaged. Karen provides clear photos showing the damage, and the cost of shipping a replacement is low compared to the potential cost of contesting the dispute. After reviewing the evidence, FashionFusion decides to accept the loss and promptly issues a refund to Karen. This resolution not only saves time and resources for FashionFusion but also leaves Karen satisfied with the quick and fair resolution.
Providing shipping or delivery evidence is crucial in resolving disputes where a customer claims non-receipt of goods or delayed delivery. By submitting clear and accurate evidence, you can substantiate that the goods were shipped or delivered as agreed. This evidence plays a vital role in defending against disputes and ensuring that the resolution process is fair and transparent.
Importance of Shipping/Delivery Evidence: In disputes involving non-receipt or delayed delivery of goods, shipping or delivery evidence is often the deciding factor. This evidence helps verify that the transaction was completed according to the terms agreed upon by both the partner/merchant and the customer. Without this evidence, the dispute is likely to be resolved in favor of the customer, potentially leading to financial loss and a negative impact on your business’s reputation.
You can submit various types of evidence to support your case, including:
To effectively upload and submit shipping or delivery evidence, follow these steps:
Example
UrbanGear, an online store, receives a dispute from Chris, a customer claiming that the hiking boots he ordered were never delivered. UrbanGear gathers the shipping receipt, which includes the tracking number and delivery confirmation from the carrier, showing that the boots were delivered to Chris’s address. They use Klarna’s Dispute API to upload these documents as evidence. After reviewing the submission, Klarna resolves the dispute in UrbanGear’s favor, as the evidence clearly supports that the goods were delivered as promised.
The dispute concludes with a preliminary decision, marked as either favorable to the merchant or not.
Merchant_did_not_adjust_statement_on_klarnas_request
Merchant_did_not_follow_klarnas_shipping_policy
merchant_did_not_update_order_as_requested
Merchant_did_not_perform_promised_refund
Could_not_send_another_request.
merchant_accepted_the_loss.
merchant_did_not_reply_to_dispute_request
Methods of Submission:
/appeal
Decision-Making: