Skip to main content
POST
/
withdrawals
curl -X POST https://api.thalbank.com/withdrawals \
  -H "x-api-key: sua_api_key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 770e8400-e29b-41d4-a716-446655440002" \
  -d '{
    "amount": 50000,
    "method": "PIX",
    "pixKey": "12345678901",
    "pixKeyType": "CPF",
    "withdrawFrom": "PIX",
    "description": "Saque semanal"
  }'

{
  "status": true,
  "data": {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "amount": 50000,
    "method": "PIX",
    "status": "PENDING",
    "pixKey": "123***78901",
    "pixKeyType": "CPF",
    "description": "Saque semanal",
    "createdAt": "2026-03-10T12:00:00.000Z"
  }
}

​
Descricao

Cria uma solicitacao de saque do saldo disponivel na wallet. O saque e processado via PIX para a chave informada.
Requer header Idempotency-Key com UUID v4 unico.

​
Request

​
Headers

​
Idempotency-Key
string
required
UUID v4 unico para garantir idempotencia.

​
Body

​
amount
integer
required
Valor do saque em centavos. Minimo: 1 centavo. Deve ser menor ou igual ao saldo disponivel.
​
method
string
required
Metodo de saque. Valores: PIX, CRYPTO
​
pixKey
string
Chave PIX de destino. Obrigatorio quando method = PIX.
​
pixKeyType
string
Tipo da chave PIX. Obrigatorio quando method = PIX. Valores: CPF, CNPJ, PHONE, EMAIL, EVP
​
withdrawFrom
string
default:"PIX"
Origem do saldo. Valores: PIX, CARD, BOLETO
​
beneficiaryName
string
Nome completo do beneficiario.
​
beneficiaryDocumentType
string
Tipo do documento do beneficiario. Valores: CPF, CNPJ
​
beneficiaryDocumentNumber
string
Numero do documento do beneficiario (apenas digitos).
​
description
string
Descricao do saque (max 140 caracteres).
​
metadata
object
JSON com dados customizados.
​
cryptoWalletAddress
string
Endereco da carteira crypto. Obrigatorio quando method = CRYPTO.
curl -X POST https://api.thalbank.com/withdrawals \
  -H "x-api-key: sua_api_key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 770e8400-e29b-41d4-a716-446655440002" \
  -d '{
    "amount": 50000,
    "method": "PIX",
    "pixKey": "12345678901",
    "pixKeyType": "CPF",
    "withdrawFrom": "PIX",
    "description": "Saque semanal"
  }'

{
  "status": true,
  "data": {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "amount": 50000,
    "method": "PIX",
    "status": "PENDING",
    "pixKey": "123***78901",
    "pixKeyType": "CPF",
    "description": "Saque semanal",
    "createdAt": "2026-03-10T12:00:00.000Z"
  }
}