---
title: "Resolve an uncertain sandbox operation"
method: POST
path: "/sandbox/operations/{operation_id}/resolve"
tags: ["Sandbox"]
---

# Resolve an uncertain sandbox operation

`POST /sandbox/operations/{operation_id}/resolve`

## Request

- Base URL: `https://api.luniumpay.com`
- URL: `https://api.luniumpay.com/sandbox/operations/{operation_id}/resolve`
- Auth: API key in header `X-API-Key`

Only a test operation already in an uncertain state can be resolved. Same outcome can be replayed safely. Para venda DePix, operation_id é o cashout_id sbx_..., criado com settlement_uncertain, já em PROCESSING. sent conclui; failed passa por REFUNDING e REFUNDED após cerca de 4 segundos.

## Path parameters

- `operation_id` string, required

## Request body

- object
  - `outcome` 'sent' | 'failed', required

## Response `200`

Sandbox result; sandbox=true; no real funds move.

- object

## Other responses

- `400`: outcome ausente ou diferente de sent e failed: erro outcome_invalido, acao corrigir, sandbox=true. A checagem vem antes de procurar a operação, e nada muda no simulador (desde a 1.44.1; antes, um corpo sem outcome podia responder 200 sem resolver nada).
- `401`: Missing or invalid key.
- `403`: Requires a sandbox key.
- `404`: Operation not found for this key.
- `409`: State conflict or divergent idempotency parameters.
- `503`: Simulator unavailable; never falls through to a real provider.

---

[API](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil.md) · [All operations](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/llms.txt) · [OpenAPI document](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/revisions/0b5a340fa9dd?raw)