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"
}
}
{
"statusCode": 422,
"message": "Insufficient balance",
"error": "Unprocessable Entity"
}
Withdrawals
Criar Saque
Solicita um saque do saldo disponivel via PIX
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"
}
}
{
"statusCode": 422,
"message": "Insufficient balance",
"error": "Unprocessable Entity"
}
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
string
required
UUID v4 unico para garantir idempotencia.
Body
integer
required
Valor do saque em centavos. Minimo: 1 centavo. Deve ser menor ou igual ao saldo disponivel.
string
required
Metodo de saque. Valores:
PIX, CRYPTOstring
Chave PIX de destino. Obrigatorio quando
method = PIX.string
Tipo da chave PIX. Obrigatorio quando
method = PIX.
Valores: CPF, CNPJ, PHONE, EMAIL, EVPstring
default:"PIX"
Origem do saldo. Valores:
PIX, CARD, BOLETOstring
Nome completo do beneficiario.
string
Tipo do documento do beneficiario. Valores:
CPF, CNPJstring
Numero do documento do beneficiario (apenas digitos).
string
Descricao do saque (max 140 caracteres).
object
JSON com dados customizados.
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"
}
}
{
"statusCode": 422,
"message": "Insufficient balance",
"error": "Unprocessable Entity"
}
Was this page helpful?