Solicitar Saque

curl -X POST https://carteira.nevermissapps.com/v1/withdraw \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pixKey": "[email protected]",
    "turbo": false
  }'

curl -X POST https://carteira.nevermissapps.com/v1/withdraw \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pixKey": "[email protected]",
    "turbo": true
  }'

// Saque Turbo (padrão)
const response = await fetch('https://carteira.nevermissapps.com/v1/withdraw', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SUA_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ 
    pixKey: '[email protected]',
    turbo: true 
  })
});

// Saque Normal
const response = await fetch('https://carteira.nevermissapps.com/v1/withdraw', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SUA_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ 
    pixKey: '[email protected]',
    turbo: false 
  })
});

import requests

# Saque Turbo
response = requests.post(
    'https://carteira.nevermissapps.com/v1/withdraw',
    headers={
        'Authorization': 'Bearer SUA_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'pixKey': '[email protected]',
        'turbo': True
    }
)

# Saque Normal
response = requests.post(
    'https://carteira.nevermissapps.com/v1/withdraw',
    headers={
        'Authorization': 'Bearer SUA_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'pixKey': '[email protected]',
        'turbo': False
    }
)

{
  "success": true,
  "message": "Saque turbo solicitado com sucesso! O valor será enviado em instantes.",
  "withdrawal": {
    "txid": "CW1706743200ABC",
    "cartwaveId": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 100.00,
    "netAmount": 96.50,
    "fee": 3.50,
    "feeType": "turbo",
    "pixKey": "[email protected]",
    "pixKeyOwner": "João Silva",
    "status": "processing",
    "isTurbo": true,
    "requestedAt": 1706743200000,
    "previousBalance": 150.00,
    "newBalance": 50.00
  }
}

{
  "success": true,
  "message": "Saque normal agendado com sucesso! O valor será processado em até 24 horas.",
  "withdrawal": {
    "txid": "CW1706743200XYZ",
    "amount": 100.00,
    "netAmount": 99.50,
    "fee": 0.50,
    "feeType": "normal",
    "pixKey": "[email protected]",
    "pixKeyOwner": "João Silva",
    "status": "scheduled",
    "isTurbo": false,
    "requestedAt": 1706743200000,
    "estimatedProcessingAt": 1706829600000,
    "previousBalance": 150.00,
    "newBalance": 50.00
  }
}
    "isPartialTransfer": false,
    "pixKey": "[email protected]",
    "type": "turbo",
    "processedAt": 1698765432000
  }
}

{
  "error": "Bad Request",
  "message": "PIX key not configured. Please configure your PIX key first"
}

{
  "error": "Bad Request",
  "message": "Insufficient balance. Minimum R$ 5.00 required"
}

{
  "error": "Forbidden",
  "message": "Cannot withdraw manually when auto-withdrawal is enabled"
}

{
  "success": false,
  "message": "Seus saques foram bloqueados. Entre em contato com o suporte."
}

{
  "success": false,
  "message": "Os saques estão temporariamente bloqueados. Tente novamente mais tarde."
}

POST

withdraw

curl -X POST https://carteira.nevermissapps.com/v1/withdraw \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pixKey": "[email protected]",
    "turbo": false
  }'

curl -X POST https://carteira.nevermissapps.com/v1/withdraw \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pixKey": "[email protected]",
    "turbo": true
  }'

// Saque Turbo (padrão)
const response = await fetch('https://carteira.nevermissapps.com/v1/withdraw', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SUA_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ 
    pixKey: '[email protected]',
    turbo: true 
  })
});

// Saque Normal
const response = await fetch('https://carteira.nevermissapps.com/v1/withdraw', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SUA_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ 
    pixKey: '[email protected]',
    turbo: false 
  })
});

import requests

# Saque Turbo
response = requests.post(
    'https://carteira.nevermissapps.com/v1/withdraw',
    headers={
        'Authorization': 'Bearer SUA_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'pixKey': '[email protected]',
        'turbo': True
    }
)

# Saque Normal
response = requests.post(
    'https://carteira.nevermissapps.com/v1/withdraw',
    headers={
        'Authorization': 'Bearer SUA_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'pixKey': '[email protected]',
        'turbo': False
    }
)

{
  "success": true,
  "message": "Saque turbo solicitado com sucesso! O valor será enviado em instantes.",
  "withdrawal": {
    "txid": "CW1706743200ABC",
    "cartwaveId": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 100.00,
    "netAmount": 96.50,
    "fee": 3.50,
    "feeType": "turbo",
    "pixKey": "[email protected]",
    "pixKeyOwner": "João Silva",
    "status": "processing",
    "isTurbo": true,
    "requestedAt": 1706743200000,
    "previousBalance": 150.00,
    "newBalance": 50.00
  }
}

{
  "success": true,
  "message": "Saque normal agendado com sucesso! O valor será processado em até 24 horas.",
  "withdrawal": {
    "txid": "CW1706743200XYZ",
    "amount": 100.00,
    "netAmount": 99.50,
    "fee": 0.50,
    "feeType": "normal",
    "pixKey": "[email protected]",
    "pixKeyOwner": "João Silva",
    "status": "scheduled",
    "isTurbo": false,
    "requestedAt": 1706743200000,
    "estimatedProcessingAt": 1706829600000,
    "previousBalance": 150.00,
    "newBalance": 50.00
  }
}
    "isPartialTransfer": false,
    "pixKey": "[email protected]",
    "type": "turbo",
    "processedAt": 1698765432000
  }
}

{
  "error": "Bad Request",
  "message": "PIX key not configured. Please configure your PIX key first"
}

{
  "error": "Bad Request",
  "message": "Insufficient balance. Minimum R$ 5.00 required"
}

{
  "error": "Forbidden",
  "message": "Cannot withdraw manually when auto-withdrawal is enabled"
}

{
  "success": false,
  "message": "Seus saques foram bloqueados. Entre em contato com o suporte."
}

{
  "success": false,
  "message": "Os saques estão temporariamente bloqueados. Tente novamente mais tarde."
}

Descrição

Solicita um saque do seu saldo disponível para uma chave PIX. Existem dois tipos: Normal (R

0,50 - 24h) e **Turbo** (R

3,50 - instantâneo).

Importante: A chave PIX deve ser fornecida no body da requisição e será validada antes do processamento.

Headers

string

required

Bearer token com sua API Key

string

required

Deve ser application/json

Body

string

required

Chave PIX de destino (pode ser diferente da cadastrada)

boolean

default:true

true para saque turbo (instantâneo), false para saque normal (agendado para 24h)

Tipos de Saque

Normal

Taxa: R$ 0,50Tempo: Agendado para processamento em até 24 horasMínimo: R$ 10,00Status: scheduled → processing → completed

Turbo

Taxa: R$ 3,50Tempo: Instantâneo (processado imediatamente)Mínimo: R$ 10,00Status: processing → completedBônus: +1 dia de plano de vendas

Saque único: Você só pode ter um saque em processamento por vez.

Saque Normal: É agendado e processado automaticamente pelo sistema em até 24 horas. Você pode cancelar um saque normal agendado usando /v1/withdraw/cancel.

Pré-requisitos

Chave PIX válida

A chave PIX fornecida no body será validada antes de processar o saque

Saldo mínimo

Saldo disponível deve ser de pelo menos R$ 10,00 (após descontar taxas)

Sem saque pendente

Não pode haver outro saque em processamento

Limites de saque

Diário (6h-20h): Limite configurado pelo sistema Noturno (20h-6h): Limite reduzido Os limites são cumulativos nas últimas 24 horas

Saques não bloqueados

Sua conta não pode ter saques bloqueados pelo sistema ou administrador

Sistema de saques ativo

Os saques globais não podem estar temporariamente bloqueados

Response

boolean

Indica sucesso

string

Mensagem de confirmação

object

Detalhes do saque

Show properties

string

ID único da transação de saque

string

ID da transferência no Cartwave (apenas turbo)

number

Valor bruto do saque

number

Valor líquido que você receberá

number

Taxa cobrada (R

0,50 normal ou R

3,50 turbo)

string

Tipo da taxa: normal ou turbo

string

Chave PIX de destino

string

Nome do titular da chave PIX

string

Status: processing (turbo) ou scheduled (normal)

boolean

Se é saque turbo

number

Timestamp da solicitação (em milissegundos)

number

Quando será processado - apenas para normal (em milissegundos)

number

Saldo antes do saque

number

Saldo após o saque

curl -X POST https://carteira.nevermissapps.com/v1/withdraw \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pixKey": "[email protected]",
    "turbo": false
  }'

curl -X POST https://carteira.nevermissapps.com/v1/withdraw \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pixKey": "[email protected]",
    "turbo": true
  }'

// Saque Turbo (padrão)
const response = await fetch('https://carteira.nevermissapps.com/v1/withdraw', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SUA_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ 
    pixKey: '[email protected]',
    turbo: true 
  })
});

// Saque Normal
const response = await fetch('https://carteira.nevermissapps.com/v1/withdraw', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SUA_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ 
    pixKey: '[email protected]',
    turbo: false 
  })
});

import requests

# Saque Turbo
response = requests.post(
    'https://carteira.nevermissapps.com/v1/withdraw',
    headers={
        'Authorization': 'Bearer SUA_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'pixKey': '[email protected]',
        'turbo': True
    }
)

# Saque Normal
response = requests.post(
    'https://carteira.nevermissapps.com/v1/withdraw',
    headers={
        'Authorization': 'Bearer SUA_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'pixKey': '[email protected]',
        'turbo': False
    }
)

{
  "success": true,
  "message": "Saque turbo solicitado com sucesso! O valor será enviado em instantes.",
  "withdrawal": {
    "txid": "CW1706743200ABC",
    "cartwaveId": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 100.00,
    "netAmount": 96.50,
    "fee": 3.50,
    "feeType": "turbo",
    "pixKey": "[email protected]",
    "pixKeyOwner": "João Silva",
    "status": "processing",
    "isTurbo": true,
    "requestedAt": 1706743200000,
    "previousBalance": 150.00,
    "newBalance": 50.00
  }
}

{
  "success": true,
  "message": "Saque normal agendado com sucesso! O valor será processado em até 24 horas.",
  "withdrawal": {
    "txid": "CW1706743200XYZ",
    "amount": 100.00,
    "netAmount": 99.50,
    "fee": 0.50,
    "feeType": "normal",
    "pixKey": "[email protected]",
    "pixKeyOwner": "João Silva",
    "status": "scheduled",
    "isTurbo": false,
    "requestedAt": 1706743200000,
    "estimatedProcessingAt": 1706829600000,
    "previousBalance": 150.00,
    "newBalance": 50.00
  }
}
    "isPartialTransfer": false,
    "pixKey": "[email protected]",
    "type": "turbo",
    "processedAt": 1698765432000
  }
}

{
  "error": "Bad Request",
  "message": "PIX key not configured. Please configure your PIX key first"
}

{
  "error": "Bad Request",
  "message": "Insufficient balance. Minimum R$ 5.00 required"
}

{
  "error": "Forbidden",
  "message": "Cannot withdraw manually when auto-withdrawal is enabled"
}

{
  "success": false,
  "message": "Seus saques foram bloqueados. Entre em contato com o suporte."
}

{
  "success": false,
  "message": "Os saques estão temporariamente bloqueados. Tente novamente mais tarde."
}

Erros Comuns

Código	Causa	Solução
400	Chave PIX não fornecida	Envie pixKey no body da requisição
400	Saldo menor que R$ 10,00	Aguarde mais pagamentos
400	Saldo insuficiente para taxa	Aguarde mais pagamentos
400	MEDs ativos congelando saldo	Resolva as contestações
403	Saque automático ativo	Entre em contato com suporte para desativar
403	Saques bloqueados (conta)	Entre em contato com suporte
403	Saques bloqueados (sistema)	Aguarde liberação do sistema
409	Já há saque pendente	Aguarde processamento
429	Já existe saque sendo processado	Aguarde alguns segundos

Começando

Conceitos

API - Introdução

API - Pagamentos

API - Saldo e Saques

API - Transações

API - Relatórios

API - MEDs (Contestações)

API - Split

Descrição

Headers

Body

Tipos de Saque

Normal

Turbo

Pré-requisitos

Response

Erros Comuns

​Descrição

​Headers

​Body

​Tipos de Saque

Normal

Turbo

​Pré-requisitos

​Response

​Erros Comuns

Descrição

Headers

Body

Tipos de Saque

Pré-requisitos

Response

Erros Comuns