API Endpoint

GET /dispute-api/v1/{dispute_id}

Request Parameters

Field	Subfield	Input Type	Required	Length Limit	Description / Rules
dispute_id		string	Yes	1-50	Dispute ID

Response Parameters

Level 1 Field	Level 2 Field	Level 3 Field	Level 4 Field	Type	Description
code				string	API result code, 200
msg				string	Result description, e.g. PARAM_ERROR
data				object	Node
	terminal			string	Returned terminal number
	currency			string	Returned transaction currency
	amount			string	Returned transaction amount
	methods			string	Returned payment method
	payment_id			string	Returned payment ID
	merchant			object	Node
		order_id		string	Returned merchant order number
	status			string	Processing status: pending (unprocessed) close (processed) noaction (no action required)
	transaction_data			object	Node
		transaction_referrer		string	Returned source URL
		transaction_time		string	Returned transaction time, converted timestamp, UTC+8 format: 2026-04-02T16:28:09+08:00
	disputes			object	Node
		disputes_id		string	Dispute ID
		disputes_type		string	Dispute type: dispute = dispute disputes-period = appeal period
		disputes_reason		string	Reason: goods_not_received: service not provided or goods not received return: refund / return incorrect_invoice: cancelled goods/service already_paid:duplicate transaction faulty-goods: goods not as described / damaged pandemic_impact: pandemic impact unauthorized_purchase: unauthorized transaction
		disputes_reference		string	Reference number
		disputes_amount		string	Dispute amount
		disputes_currency		string	Dispute currency
		disputes_times		string	Number of disputes
		disputes_period_from		string	Appeal period start time, converted timestamp, UTC+8 format: 2026-04-02T16:28:09+08:00
		disputes_period_to		string	Appeal period end time, converted timestamp, UTC+8 format: 2026-04-02T16:28:09+08:00
		disputes_date		string	Dispute time, converted timestamp, UTC+8 format: 2026-04-02T16:28:09+08:00
		disputes_comment		string	Dispute description
		disputes_comments_history		string	Dispute comment history
		disputes_reply_deadline		string	Reply deadline, converted timestamp, UTC+8 format: 2026-04-02T16:28:09+08:00
		disputes_appeal_status		string	Appeal status: false: No appeal true: Appeal in progress
		disputes_status		string	Close status: open: Klarna processing, Open close: Klarna closed, Closed
		dispute_evidence		Array
			evidence_code	string	Appeal evidence code
			evidence_description	string	English display name of appeal evidence
			evidence_optional	string	Whether this evidence is required
			evidence_example	string	Example text description for appeal evidence
			evidence_submitted	string	Merchant submitted text description
			evidence_file	Array	Merchant uploaded file IDs
		dispute_data		object
			"{key}":"{value}"	string	Fields requiring appeal submission. key is the field name, value is the saved value
	billing			object	Node
		firstname		string	Consumer first name
		lastname		string	Consumer last name
		email		string	Consumer email, may contain masked characters, used for PG refunds
		phone		string	Consumer phone number
		country		string	Consumer billing country
		state		string	Consumer state/province
		city		string	Consumer city
		address		string	Consumer detailed address
		postal_code		string	Consumer postal code
	refund			object	Node
		refund_amount		string	Refund amount
		refund_currency		string	Refund currency
	tracking			object	Node
		tracking_number		string	Logistics tracking number
	result_code			string	Returned response code
	result_message			string	Returned response message