Skip to main content

Mark a sandbox charge as failed through the canonical flow

POST 

/v1/_test/charges/:id/simulate-failed

This authenticated, merchant-scoped helper is exclusive to sandbox. It produces the same durable effects as the canonical failure transition and preserves the original response across retries.

Request​

Responses​

Canonical transition completed or original response returned.

Did this page unblock the next step?

Feedback stays inside the docs flow and should never include customer or card data.

mupag / support

How can we help?

Quick answers, AI and our team.

Frequently asked questions

How do I start integrating?

Follow the quickstart, configure the QA environment and create your first test charge.

Read documentation
My PIX payment is pending. What now?

Confirmation is asynchronous. Check the charge status and webhook events before fulfilling the order.

Read documentation
How do I receive payment notifications?

Register a webhook endpoint, verify its signature and handle duplicate events safely.

Read documentation
How do subscriptions work?

Read the subscriptions guide to configure recurring billing and follow the charge lifecycle.

Read documentation
Where can I find authentication help?

See how to use environment credentials in the documentation. Never share your key in chat.

Read documentation