---
title: "Merchant action"
method: POST
path: "/v1/disputes/{disputeId}/actions"
tags: ["Disputes"]
---

# Merchant action

`POST /v1/disputes/{disputeId}/actions`

## Request

- Base URL: `https://api.sandbox.eu.ppro.com`
- URL: `https://api.sandbox.eu.ppro.com/v1/disputes/{disputeId}/actions`
- Auth: none declared

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

## Path parameters

- `disputeId` string, required

## Headers

- `Request-Reference` string
- `Request-Idempotency-Key` string

## Request body

- MerchantActionRequest: Request body for merchant action
  - `type` 'ACCEPT' | 'CHALLENGE' | 'OFFER', required: Action that can be performed on the dispute
  - `resolution` string: The resolution chosen by the merchant for this action. Required if defined in the config for certain action types.
  - `message` string: Message text. Required if defined in the config for certain action types.
  - `amount` Amount: Amount in ISO 4217 format
    - `value` integer, required: The monetary value to be charged or processed, expressed in the smallest currency unit (e.g., cents for EUR).
    - `currency` string, required: The three-letter ISO 4217 currency code representing the currency in which the amount is denominated.

## Response `202`

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

- MerchantActionResponse
  - `disputeId` string
  - `status` string

## Other responses

- `400`: Bad Request
- `404`: Not found
- `409`: Target event could not be reset due to a concurrent update.
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ppro/apis/risk-management.md) - [All operations](https://skmtc.dev/ppro/apis/risk-management/llms.txt) - [OpenAPI document](https://skmtc.dev/ppro/apis/risk-management/revisions/13f03e5db959?raw)
