Pular para o conteúdo principal
POST
/
v1
/
cashouts
Solicitar saque
curl --request POST \
  --url https://api-payment.safefypay.com.br/v1/cashouts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 50000
}
'
{
  "data": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
    "externalId": "saque_001",
    "amount": 50000,
    "fee": 200,
    "netAmount": 49800,
    "currency": "BRL",
    "status": "Pending",
    "environment": "Sandbox",
    "pix": {
      "pixKeyType": "CPF",
      "pixKey": "***456789**",
      "endToEndId": null
    },
    "requestedAt": "2025-01-15T16:00:00Z",
    "processedAt": null,
    "completedAt": null,
    "failureReason": null,
    "createdAt": "2025-01-15T16:00:00Z"
  },
  "message": "Saque solicitado com sucesso.",
  "error": null
}
Solicita uma transferencia de fundos da sua conta Safefy para uma conta bancaria via PIX.

​
Parametros

​
amount
integer
obrigatório
Valor do saque em centavos. Exemplo: R$ 500,00 = 50000.
​
pixKeyType
string
obrigatório
Tipo da chave PIX: CPF, CNPJ, Email, Phone ou Random.
​
pixKey
string
obrigatório
Valor da chave PIX do destinatario.
​
externalId
string
Identificador externo no seu sistema.
​
description
string
Descricao do saque.
Certifique-se de ter saldo disponivel suficiente antes de solicitar um saque. O valor sera reservado imediatamente.

Autorizações

​
Authorization
string
header
obrigatório

Token JWT obtido via /v1/auth/token

Corpo

application/json
​
amount
integer<int64>
obrigatório

Valor do saque em centavos

Exemplo:

50000

​
payoutAccountId
string<uuid> | null

ID da conta de destino (usa padrao se omitido)

Exemplo:

null

​
externalId
string | null

ID externo para referencia

Exemplo:

"saque_001"

​
callbackUrl
string | null

URL para receber webhooks

Exemplo:

"https://seusite.com.br/webhook/cashout"

Resposta

Saque solicitado com sucesso

​
data
object
​
message
string | null
​
error
object