---
title: "Solicitar saque"
method: POST
path: "/v1/cashouts"
tags: ["Saques"]
---

# Solicitar saque

`POST /v1/cashouts`

Solicita um novo saque do seu saldo disponivel para a chave PIX informada.

## Request body

- CreateCashoutRequest
  - `amount` integer, required — Valor do saque em centavos. Exemplo: R$ 500,00 = 50000.
  - `pixKeyType` 'CPF' | 'CNPJ' | 'Email' | 'Phone' | 'Random', required — Tipo da chave PIX de destino.
  - `pixKey` string, required — Chave PIX de destino.
  - `externalId` string, nullable — ID externo no seu sistema para referencia cruzada.
  - `callbackUrl` string, nullable — URL para receber webhooks de atualizacao de status do saque.

## Response `201`

Saque solicitado com sucesso

- CreateCashoutResponse
  - `data` CashoutData, nullable
    - `id` string, uuid — ID unico do saque
    - `externalId` string, nullable — ID externo informado
    - `amount` integer — Valor solicitado (centavos)
    - `fee` integer — Taxa cobrada (centavos)
    - `netAmount` integer — Valor liquido (centavos)
    - `currency` string — Moeda
    - `status` 'Pending' | 'Processing' | 'Completed' | 'Failed' | 'Rejected' | 'Cancelled' — Status do saque
    - `environment` 'Sandbox' | 'Production' — Ambiente
    - `pix` CashoutPixData
      - `pixKeyType` string, nullable — Tipo da chave PIX
      - `pixKey` string, nullable — Chave PIX (mascarada)
      - `endToEndId` string, nullable — ID da transacao PIX
    - `requestedAt` string, date-time — Data da solicitacao
    - `processedAt` string, date-time, nullable — Data do inicio do processamento
    - `completedAt` string, date-time, nullable — Data da conclusao
    - `failureReason` string, nullable — Motivo da falha
    - `createdAt` string, date-time — Data de criacao
  - `message` string, nullable
  - `error` ApiErrorResponse, nullable
    - `message` string — Mensagem de erro
    - `code` string — Codigo do erro

## Other responses

- `400` — Dados invalidos ou saldo insuficiente
- `401` — Nao autorizado
- `500` — Erro interno

---

[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)