v1

latestOpenAPI 3.1.02026-07-2663312285.4 KB
Disputes

Merchant action

Use this endpoint to perform actions like accept, challenge or offer on a dispute

post/v1/disputes/{disputeId}/actions

Path parameters

disputeIdstring required

Dispute ID starting with 'dispute_' followed by 21 alpha-numeric characters.

Headers

Request-Referencestring

Optional Reference for the request. This is used to identify the request in debugging.

Request-Idempotency-Keystring

Optional Idempotency Key for the request. Sending duplicate requests will result in 409 HTTP status code.

Request body

type'ACCEPT' | 'CHALLENGE' | 'OFFER' required

Action that can be performed on the dispute

resolutionstring

The resolution chosen by the merchant for this action. Required if defined in the config for certain action types.

messagestring

Message text. Required if defined in the config for certain action types.

Example request

{
  "resolution": "partial-refund",
  "message": "We offer a partial refund of $80 for this transaction."
}

Response

Success with status as ACCEPT_PROCESSING, CHALLENGE_PROCESSING or OFFER_PROCESSING depending on the action

disputeIdstring
statusstring