Close dispute

POST /disputes/{id}/close: the same as accepting, refund included.

POSThttps://api.wajub.com/disputes/{id}/close

Private key required

Dispute endpoints take a private (sk.…) or restricted key, in live and in sandbox. A public key gets a 406.

Closing a dispute accepts it

close does exactly what accept does: you lose the dispute and the customer is refunded. It is not a way to file a dispute away after a decision reached elsewhere.

The dispute moves to lost, and Wajub refunds the disputed amount, up to what is still refundable on the payment. If that refund cannot be created, the call fails and the dispute stays as it was. Three cases create no refund and still end the dispute lost: a chargeback (the payer's bank has already returned the money), a payment already refunded in full, and a dispute in another currency than its payment. The dispute has to be open or under_review, otherwise the call answers 422.

merchant_responsestringoptional

Up to 2 000 characters, stored on the dispute.

The response is the dispute, now lost. dispute.lost and dispute.closed follow by webhook.

POSThttps://api.wajub.com/disputes/{id}/close

Request

curl https://api.wajub.com/disputes/dsp_hrgUOE225KMKULRQqYvl/close \
  -H "Authorization: sk.xxxxxxxxxxxxxxxx…"

Response · 200 OK

{

"code": 200,

"status": "OK",

"message": "Dispute closed",

"dispute": {

"id": "dsp_hrgUOE225KMKULRQqYvl",

"status": "lost",

"merchant_response": "Merchant accepted the dispute.",

"resolved_at": "2026-07-16T11:04:52+00:00"

}

What did you think of this content?