---
title: "Marca uma cobrança sandbox como falha pelo fluxo canônico"
method: POST
path: "/v1/_test/charges/{id}/simulate-failed"
tags: ["Sandbox"]
---

# Marca uma cobrança sandbox como falha pelo fluxo canônico

`POST /v1/_test/charges/{id}/simulate-failed`

## Request

- Base URL: `https://api.sandbox.mupag.com.br`
- URL: `https://api.sandbox.mupag.com.br/v1/_test/charges/{id}/simulate-failed`
- Auth: HTTP bearer

Operação auxiliar autenticada, isolada por lojista e exclusiva de sandbox. Produz os mesmos
efeitos duráveis da transição canônica de falha e preserva a resposta original em novas tentativas.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Response `200`

Transição canônica concluída ou resposta original retornada.

- SandboxTestResult
  - `id` string, uuid, required
  - `status` string, required
  - `updated_at` string, date-time, required

## Other responses

- `401`: Falha de autenticação
- `403`: Permissão insuficiente
- `404`: Recurso não encontrado
- `409`: Conflito de idempotência ou estado
- `422`: Erro de validação

---

[API](https://skmtc.dev/mupag/apis/mupag-public-merchant-api.md) · [All operations](https://skmtc.dev/mupag/apis/mupag-public-merchant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mupag/apis/mupag-public-merchant-api/revisions/677904516d2d?raw)