Manage payment disputes effectively with Klarna’s Dispute API by integrating dispute handling, tracking lifecycle stages, and providing evidence for swift resolution.
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 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 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:
Overview: A customer initiates a dispute.
Webhook: payment.dispute.state-change.pre-arbitration
Recommended action: Partners should review the related transaction and consider reaching out to the customer to resolve the dispute directly.
Alternatively, Partner may accept loss. Doing so at this stage does to incur a dispute fee.
State duration: The duration a dispute remains in Pre-arbitration depends on the type of dispute.
Dispute reason | State duration |
---|---|
Purchase Unauthorized | Will transition immediately to Arbitration Pending. |
Return not possible Return not refunded Products or services not received Products defective or not as described Incorrect amount | Will remain in the initial state for 21 days before transitioning to Arbitration Pending. |
Klarna discretion: Klarna dispute agents have the authority to advance a dispute to the next state prior to the completion of the 21-day period, based on their discretion. These scenarios include, but are not limited to:
Overview: The deadline for Merchant and customer to resolve the dispute directly has expired, Klarna will now investigate the dispute.
Webhook: payment.dispute.state-change.arbitration-pending
Recommended action: This stage represents that Klarna is deliberating the dispute details and merchant evidence provided. The first time a dispute enters this stage, it typically immediately transitions to Merchant Evidence Pending (since there is not yet any evidence provided by merchant to review).
There is no action expected of Partner while dispute is in this state.
Overview: Klarna requests evidence from the Partner/Merchant.
Webhook: payment.dispute.state-change.merchant-evidence-pending
Recommended action: Partners/Merchants must upload and attach evidence via the Dispute API.
payment_dispute_attachment_id.
This first step simply uploads the file to Klarna, but it has not yet associated it to the dispute.payment_dispute_attachment_id
into the attachments
field of this request. This now associates the evidence to the particular dispute.State duration: Partners/Merchants are given 14 days to attach evidence. The dispute will remain in this state until evidence is submitted, or the window for evidence submission expires.
Overview: An initial decision has been made by Klarna in favor of customer. Merchants are able to submit an appeal for a dispute decision by providing a summary of Klarna's decision error and supporting evidence.
Webhook: payment.dispute.state-change.arbitration-appeal-window-open
Recommended action: Partners/Merchants can submit the appeal via Disputes API.
State duration: Partners/Merchants have 10 days to submit an appeal. The dispute will remain in this state until an appeal is submitted, or the dispute is closed after 10 days of no appeal submission.
Overview: Final dispute resolution is reached
Webhook: payment.dispute.state-change.closed
Recommended action: If the dispute closes in favor of the customer, the Partner/Merchant may incur a chargeback. If the disputes closes in favor of 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:
In certain situations, it may be more practical for a partner 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 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 Partner or not.
It is at Klarna's discretion to determine whether a dispute qualifies for an appeal.
ARBITRATION_APPEAL_WINDOW_OPEN
state, allowing Partners the opportunity to submit an appeal. The general process may look like this:Pre Arbitration
Arbitration Pending
Merchant Evidence Pending
Arbitration Pending
Arbitration Appeal Window Open
Arbitration Pending
Closed
Pre Arbitration
Arbitration Pending
Merchant Evidence Pending
Arbitration Pending
Closed
ARBITRATION_APPEAL_WINDOW_OPEN
status. Klarna will automatically close the dispute if the Acquiring Partner or Partner does not appeal the preliminary dispute outcome.Partner portal Disputes App:
Klarna Network Disputes API:
Dispute eligible for appeal
ARBITRATION_PENDING
and Klarna service center agents will investigate the dispute again.Decision-Making:
ARBITRATION_PENDING
to ARBITRATION_APPEAL_WINDOW_OPEN
), they may face a temporary suspension from the Arbitration process for a duration on 1 month. This suspension is triggered as soon as the Partner surpasses the 30% loss rate threshold. To be eligible for this calculation, the Partner must have handled more than 10 disputes in the preceding month.ARBITRATION_APPEAL_WINDOW_OPEN
will remain eligible for appeal. However, new disputes will not be eligible for the appeal.