Accept Dispute

POSThttps://api.omise.co/disputes/:id/accept

Accept a dispute to concede to the customer's claim. This action is irreversible and immediately closes the dispute with status "lost". The disputed amount will be returned to the customer.

---

Request Parameters

Required - 1 fieldRequired Parameters

▼

`id`STRING(required)

Dispute ID to accept (path parameter). The dispute must have status "open" or "pending".

Example:"dspt_test_5xuy4w91xqz7d1w9u0t"

---

Responses

200

Dispute accepted

Dispute accepted successfully. The dispute status is now "lost" and the process is complete.

After accepting:

• status - Changes to "lost"
• closed_at - Set to current timestamp
• Disputed amount is returned to the customer
• This action is irreversible
• No further updates can be made to this dispute

400

Bad request

Request validation failed. Check the error message for details.

Common causes:

• Invalid dispute ID format
• Missing dispute ID

401

Unauthorized

Authentication failed. Invalid or missing API key.

Common causes:

• Missing Authorization header
• Invalid secret key
• Using public key instead of secret key
• Incorrect HTTP Basic Auth format

404

Not found

Dispute not found.

Common causes:

• Incorrect dispute ID
• Dispute belongs to different account
• ID typo or formatting error

422

Unprocessable entity

Dispute cannot be accepted.

Common causes:

• Dispute is already closed (won or lost)
• Dispute status does not allow acceptance
• Acceptance deadline has passed

5xx

Server error

Server-side error occurred. These are rare but should be handled gracefully.

How to handle:

• Retry the request with exponential backoff
• Check status.omise.co for service incidents
• See Error Handling for detailed guidance

---

Code samples

cURL

curl https://api.omise.co/disputes/dspt_test_5xuy4w91xqz7d1w9u0t/accept \
  -X POST \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

dispute = Omise::Dispute.accept('dspt_test_5xuy4w91xqz7d1w9u0t')

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

dispute = omise.Dispute.accept('dspt_test_5xuy4w91xqz7d1w9u0t')

Node.js

const omise = require('omise')({
  secretKey: 'skey_test_5xuy4w91xqz7d1w9u0t'
});

const dispute = await omise.disputes.accept('dspt_test_5xuy4w91xqz7d1w9u0t');

PHP

<?php
define('OMISE_SECRET_KEY', 'skey_test_5xuy4w91xqz7d1w9u0t');

$dispute = OmiseDispute::accept('dspt_test_5xuy4w91xqz7d1w9u0t');

Java

Client client = new Client.Builder()
    .secretKey("skey_test_5xuy4w91xqz7d1w9u0t")
    .build();

Dispute dispute = client.disputes().accept("dspt_test_5xuy4w91xqz7d1w9u0t");

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var dispute = await client.Disputes.Accept("dspt_test_5xuy4w91xqz7d1w9u0t");

Go

client, _ := omise.NewClient(
    "pkey_test_5xuy4w91xqz7d1w9u0t",
    "skey_test_5xuy4w91xqz7d1w9u0t",
)

dispute, _ := client.AcceptDispute("dspt_test_5xuy4w91xqz7d1w9u0t")

---

Error and result codes

Common Error Codes

Code	Description	Resolution
authentication_failure	Invalid API key	Verify your secret key is correct
not_found	Dispute not found	Check dispute ID is correct
dispute_already_closed	Dispute is already closed	Cannot accept a closed dispute
invalid_dispute_status	Dispute status invalid	Only open or pending disputes can be accepted

Status Transition

Before	After	Result
open	lost	Dispute accepted, funds returned to customer
pending	lost	Dispute accepted, funds returned to customer

When to Accept a Dispute

Consider accepting a dispute when:

• You cannot provide sufficient evidence to contest the claim
• The customer's claim is legitimate
• The cost of fighting exceeds the disputed amount
• You want to resolve quickly and maintain customer goodwill

---

🔑API Credentials

▼

Try it out

Required - 1 fields

▼

id(Required)

Your IP: ...Loading...