> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear disputa

> Este endpoint crea una disputa para una transacción específica

### Parámetros

<ParamField path="transactionId" type="string" required>
  El identificador único de la transacción a disputar
</ParamField>

### Cuerpo

<ParamField body="textEvidence" type="string" required>
  Evidencia en texto que describe el motivo de la disputa
</ParamField>

### Respuesta

<ResponseField name="success" type="boolean">
  Indica si la operación fue exitosa
</ResponseField>

<ResponseField name="disputeId" type="string">
  El identificador único de la disputa
</ResponseField>

<ResponseField name="transactionId" type="string">
  El ID de la transacción que se está disputando
</ResponseField>

<ResponseField name="status" type="string">
  Estado de la disputa: `submitted`, `under_review`, `won`, `lost` o `needs_evidence`
</ResponseField>

<ResponseField name="createdAt" type="string">
  Fecha y hora (ISO 8601) de cuándo se creó la disputa
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request POST 'https://stablecoin-api.sandbox.getmeru.com/api/v1/cards-program/transactions/txn_1a2b3c4d5e6f7g8h/disputes' \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data-raw '{
      "textEvidence": "I did not authorize this transaction. The charge appeared on my card without my knowledge. I believe this is fraudulent activity."
  }'
  ```

  ```js Javascript theme={null}
  const response = await fetch('https://stablecoin-api.sandbox.getmeru.com/api/v1/cards-program/transactions/txn_1a2b3c4d5e6f7g8h/disputes', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'api-key': '<api-key>'
    },
    body: JSON.stringify({
      textEvidence: "I did not authorize this transaction. The charge appeared on my card without my knowledge. I believe this is fraudulent activity."
    })
  });

  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "success": true,
    "disputeId": "dsp_9z8y7x6w5v4u3t2s",
    "transactionId": "txn_1a2b3c4d5e6f7g8h",
    "status": "submitted",
    "createdAt": "2024-01-17T10:30:00Z"
  }
  ```
</ResponseExample>

### Respuestas de error

<ResponseExample>
  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized. Please check your authentication credentials."
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": "Transaction not found."
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": "This transaction has already been disputed."
  }
  ```
</ResponseExample>

### Motivos comunes de disputa

* **Transacción fraudulenta**: cargo no autorizado
* **Producto no recibido**: el comercio no entregó los bienes o servicios
* **Producto no coincide con la descripción**: el artículo es significativamente distinto a lo descrito
* **Cargo duplicado**: la misma transacción se cobró varias veces
* **Suscripción cancelada**: cobro posterior a la cancelación de la suscripción