---
title: "Simular saque (Sandbox)"
method: POST
path: "/v1/cashouts/{id}/simulate"
tags: ["Saques"]
---

# Simular saque (Sandbox)

`POST /v1/cashouts/{id}/simulate`

Simula o processamento de um saque no ambiente Sandbox.

## Path parameters

- `id` string, uuid, required

## Request body

- SimulateCashoutRequest
  - `action` 1 | 2 | 3, required — Acao: 1=Complete, 2=Fail, 3=Reject

## Response `200`

Simulacao realizada

- SimulateCashoutResponse
  - `data` SimulateCashoutData, nullable
    - `id` string, uuid
    - `externalId` string, nullable
    - `amount` integer
    - `fee` integer
    - `netAmount` integer
    - `currency` string
    - `status` string
    - `environment` string
    - `pix` SimulateCashoutPixData
      - `pixKeyType` string, nullable
      - `pixKey` string, nullable
      - `endToEndId` string, nullable
      - `acquirerTransactionId` string, nullable
    - `requestedAt` string, date-time
    - `processedAt` string, date-time, nullable
    - `completedAt` string, date-time, nullable
    - `failureReason` string, nullable
    - `createdAt` string, date-time
  - `message` string, nullable
  - `error` ApiErrorResponse, nullable
    - `message` string — Mensagem de erro
    - `code` string — Codigo do erro

## Other responses

- `400` — Acao invalida
- `401` — Nao autorizado
- `404` — Saque nao encontrado

---

[API](https://skmtc.net/safefy-pay/apis/safefy-pix-gateway.md) · [All operations](https://skmtc.net/safefy-pay/apis/safefy-pix-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safefy-pay/safefy-pix-gateway/revisions/c4fd84385e23/schema)