Overview

Retrieve and handle disputed orders, with complete Klarna dispute data.

Function

• Multi-condition query by order number, payment ID, date, and dispute type.
• Only Klarna dispute orders supported.
• Data only available for the last 30 days.
• Pagination: pages defaults to 1; count defaults to 10 per page.

Flow Chart

Dispute Order Query

1. The merchant server calls the Klarna dispute order query function and submits the required parameters.

curl -X POST '/service/DisputeOrderList'
-H 'Content-Type: application/x-www-form-urlencoded'
-d 'account=995149'
-d 'terminal=99514901'
-d 'signValue=6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b'
-d 'order_beginDate=2025-10-28 15:29:45'
-d 'order_endDate=2025-11-28 15:29:45'
-d 'date_type=dispute'

Response Data

<?xml version="1.0" encoding="utf-8"?>
<response> 
  <account>995149</account>  
  <terminal>99514901</terminal>  
  <signValue>afdcfbb0c6b9e78ce87e04124968bb9fed356ea9de330a131c120086e368108f</signValue>  
  <results>00</results>  
  <details>Success</details>  
  <count>1</count>  
  <totalpages/>  
  <pages>1</pages>  
  <orderInfo> 
    <account>995149</account>  
    <terminal>99514901</terminal>  
    <methods>Klarna</methods>  
    <payment_id>230710005935315168469</payment_id>  
    <order_number>1693304542147</order_number>  
    <order_currency>USD</order_currency>  
    <order_amount>10</order_amount>  
    <notice_type>dispute</notice_type>  
    <push_details>return</push_details>  
    <is_refund>2</is_refund>  
    <refund_amount>0</refund_amount>  
    <refund_currency>USD</refund_currency>  
    <is_chargeBack>2</is_chargeBack>  
    <chargeBack_amount>0</chargeBack_amount>  
    <chargeBack_currency>USD</chargeBack_currency>  
    <referrer>https://example.com</referrer>  
    <comment>Please provide return instructions</comment>  
    <abnormal_amount>10</abnormal_amount>  
    <abnormal_currency>USD</abnormal_currency>  
    <disputes_date>2025-08-23 10:27:59.0</disputes_date>  
    <reply_deadline>2025-09-01 23:59:59.0</reply_deadline>  
    <disputes_times>1</disputes_times> 
  </orderInfo> 
</response>

Dispute Order Processing Status

Parameter	Description
orderInfo	Node information for disputed orders. Multiple entries indicate multiple disputes.
status	Handling status 0 :Unprocessed 1: Processed 2: No action required
appeal_status	Appeal status 0: Not appealed 1: Under appeal

View full list of disputed order response parameters →