Detalhes do Saque

curl -X GET "https://carteira.nevermissapps.com/v1/withdrawals/WD1732543800ABC" \
  -H "Authorization: Bearer SUA_API_KEY"

const txid = 'WD1732543800ABC';
const response = await fetch(
  `https://carteira.nevermissapps.com/v1/withdrawals/${txid}`,
  {
    headers: {
      'Authorization': 'Bearer SUA_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data.withdrawal);

import requests

txid = 'WD1732543800ABC'
response = requests.get(
    f'https://carteira.nevermissapps.com/v1/withdrawals/{txid}',
    headers={'Authorization': 'Bearer SUA_API_KEY'}
)

data = response.json()
print(data['withdrawal'])

<?php
$txid = 'WD1732543800ABC';
$ch = curl_init("https://carteira.nevermissapps.com/v1/withdrawals/$txid");

curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer SUA_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

print_r($data['withdrawal']);
?>

{
  "success": true,
  "withdrawal": {
    "txid": "WD1732543800ABC",
    "amount": 500.00,
    "netAmount": 496.50,
    "fee": 3.50,
    "status": "completed",
    "paymentType": "turbo",
    "pixKey": "[email protected]",
    "pixKeyType": "EMAIL",
    "bankName": "Nubank",
    "accountHolder": "Empresa LTDA",
    "transferId": "TRF123456789",
    "isTurbo": true,
    "requestedAt": "2025-11-25T15:30:00.000Z",
    "scheduledFor": null,
    "completedAt": "2025-11-25T15:30:15.000Z",
    "failedAt": null,
    "failReason": null,
    "metadata": {
      "transfeera_transfer_id": "TRF123456789",
      "transfeera_batch_id": "BATCH789",
      "frozenBalance": 0,
      "balanceAlreadyDeducted": true
    },
    "createdAt": "2025-11-25T15:30:00.000Z",
    "updatedAt": "2025-11-25T15:30:15.000Z"
  },
  "transferStatus": {
    "status": "completed",
    "lastStatus": "processing",
    "provider": "transfeera"
  }
}

{
  "success": true,
  "withdrawal": {
    "txid": "WD1732457400XYZ",
    "amount": 250.00,
    "netAmount": 249.50,
    "fee": 0.50,
    "status": "scheduled",
    "paymentType": "normal",
    "pixKey": "[email protected]",
    "pixKeyType": "EMAIL",
    "bankName": null,
    "accountHolder": null,
    "transferId": null,
    "isTurbo": false,
    "requestedAt": "2025-11-24T15:30:00.000Z",
    "scheduledFor": "2025-11-25T15:30:00.000Z",
    "completedAt": null,
    "failedAt": null,
    "failReason": null,
    "metadata": {
      "frozenBalance": 0
    },
    "createdAt": "2025-11-24T15:30:00.000Z",
    "updatedAt": "2025-11-24T15:30:00.000Z"
  },
  "transferStatus": null
}

{
  "success": true,
  "withdrawal": {
    "txid": "WD1732370000DEF",
    "amount": 100.00,
    "netAmount": 96.50,
    "fee": 3.50,
    "status": "failed",
    "paymentType": "turbo",
    "pixKey": "[email protected]",
    "pixKeyType": "EMAIL",
    "bankName": null,
    "accountHolder": null,
    "transferId": "TRF987654321",
    "isTurbo": true,
    "requestedAt": "2025-11-23T15:06:40.000Z",
    "scheduledFor": null,
    "completedAt": null,
    "failedAt": "2025-11-23T15:07:40.000Z",
    "failReason": "Chave PIX inválida ou não encontrada",
    "metadata": {
      "transfeera_transfer_id": "TRF987654321",
      "error_code": "PIX_KEY_NOT_FOUND"
    },
    "createdAt": "2025-11-23T15:06:40.000Z",
    "updatedAt": "2025-11-23T15:07:40.000Z"
  },
  "transferStatus": {
    "status": "failed",
    "lastStatus": "processing",
    "provider": "transfeera"
  }
}

{
  "success": false,
  "message": "Saque não encontrado ou não pertence a este usuário"
}

GET

withdrawals

{txid}

curl -X GET "https://carteira.nevermissapps.com/v1/withdrawals/WD1732543800ABC" \
  -H "Authorization: Bearer SUA_API_KEY"

const txid = 'WD1732543800ABC';
const response = await fetch(
  `https://carteira.nevermissapps.com/v1/withdrawals/${txid}`,
  {
    headers: {
      'Authorization': 'Bearer SUA_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data.withdrawal);

import requests

txid = 'WD1732543800ABC'
response = requests.get(
    f'https://carteira.nevermissapps.com/v1/withdrawals/{txid}',
    headers={'Authorization': 'Bearer SUA_API_KEY'}
)

data = response.json()
print(data['withdrawal'])

<?php
$txid = 'WD1732543800ABC';
$ch = curl_init("https://carteira.nevermissapps.com/v1/withdrawals/$txid");

curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer SUA_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

print_r($data['withdrawal']);
?>

{
  "success": true,
  "withdrawal": {
    "txid": "WD1732543800ABC",
    "amount": 500.00,
    "netAmount": 496.50,
    "fee": 3.50,
    "status": "completed",
    "paymentType": "turbo",
    "pixKey": "[email protected]",
    "pixKeyType": "EMAIL",
    "bankName": "Nubank",
    "accountHolder": "Empresa LTDA",
    "transferId": "TRF123456789",
    "isTurbo": true,
    "requestedAt": "2025-11-25T15:30:00.000Z",
    "scheduledFor": null,
    "completedAt": "2025-11-25T15:30:15.000Z",
    "failedAt": null,
    "failReason": null,
    "metadata": {
      "transfeera_transfer_id": "TRF123456789",
      "transfeera_batch_id": "BATCH789",
      "frozenBalance": 0,
      "balanceAlreadyDeducted": true
    },
    "createdAt": "2025-11-25T15:30:00.000Z",
    "updatedAt": "2025-11-25T15:30:15.000Z"
  },
  "transferStatus": {
    "status": "completed",
    "lastStatus": "processing",
    "provider": "transfeera"
  }
}

{
  "success": true,
  "withdrawal": {
    "txid": "WD1732457400XYZ",
    "amount": 250.00,
    "netAmount": 249.50,
    "fee": 0.50,
    "status": "scheduled",
    "paymentType": "normal",
    "pixKey": "[email protected]",
    "pixKeyType": "EMAIL",
    "bankName": null,
    "accountHolder": null,
    "transferId": null,
    "isTurbo": false,
    "requestedAt": "2025-11-24T15:30:00.000Z",
    "scheduledFor": "2025-11-25T15:30:00.000Z",
    "completedAt": null,
    "failedAt": null,
    "failReason": null,
    "metadata": {
      "frozenBalance": 0
    },
    "createdAt": "2025-11-24T15:30:00.000Z",
    "updatedAt": "2025-11-24T15:30:00.000Z"
  },
  "transferStatus": null
}

{
  "success": true,
  "withdrawal": {
    "txid": "WD1732370000DEF",
    "amount": 100.00,
    "netAmount": 96.50,
    "fee": 3.50,
    "status": "failed",
    "paymentType": "turbo",
    "pixKey": "[email protected]",
    "pixKeyType": "EMAIL",
    "bankName": null,
    "accountHolder": null,
    "transferId": "TRF987654321",
    "isTurbo": true,
    "requestedAt": "2025-11-23T15:06:40.000Z",
    "scheduledFor": null,
    "completedAt": null,
    "failedAt": "2025-11-23T15:07:40.000Z",
    "failReason": "Chave PIX inválida ou não encontrada",
    "metadata": {
      "transfeera_transfer_id": "TRF987654321",
      "error_code": "PIX_KEY_NOT_FOUND"
    },
    "createdAt": "2025-11-23T15:06:40.000Z",
    "updatedAt": "2025-11-23T15:07:40.000Z"
  },
  "transferStatus": {
    "status": "failed",
    "lastStatus": "processing",
    "provider": "transfeera"
  }
}

{
  "success": false,
  "message": "Saque não encontrado ou não pertence a este usuário"
}

Descrição

Retorna informações completas sobre um saque específico, incluindo dados bancários, status de transferência e metadados.

Path Parameters

string

required

ID do saque (obtido na listagem de saques ou ao solicitar um saque)

Headers

string

required

Bearer token com sua API Key

Response

boolean

Indica se a operação foi bem-sucedida

object

Detalhes completos do saque

Show properties

string

ID único do saque

number

Valor bruto do saque

number

Valor líquido que você recebe

number

Taxa cobrada (R

0,50 normal ou R

3,50 turbo)

string

Status: scheduled, processing, completed, failed, cancelled

string

Tipo: normal ou turbo

string

Chave PIX de destino

string

Tipo da chave: CPF, CNPJ, EMAIL, PHONE, EVP

string

Nome do banco de destino

string

Nome do titular da conta

string

ID da transferência no banco (turbo)

boolean

Se é saque turbo

string

Data da solicitação (formato ISO 8601)

string

Quando será processado (normal) - formato ISO 8601

string

Quando foi concluído (formato ISO 8601)

string

Quando falhou (formato ISO 8601)

string

Motivo da falha

object

Metadados adicionais

string

Data de criação (formato ISO 8601)

string

Data da última atualização (formato ISO 8601)

object

Status da transferência na processadora

Show properties

string

Status atual na processadora

string

Último status registrado

string

Provedor da transferência

curl -X GET "https://carteira.nevermissapps.com/v1/withdrawals/WD1732543800ABC" \
  -H "Authorization: Bearer SUA_API_KEY"

const txid = 'WD1732543800ABC';
const response = await fetch(
  `https://carteira.nevermissapps.com/v1/withdrawals/${txid}`,
  {
    headers: {
      'Authorization': 'Bearer SUA_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data.withdrawal);

import requests

txid = 'WD1732543800ABC'
response = requests.get(
    f'https://carteira.nevermissapps.com/v1/withdrawals/{txid}',
    headers={'Authorization': 'Bearer SUA_API_KEY'}
)

data = response.json()
print(data['withdrawal'])

<?php
$txid = 'WD1732543800ABC';
$ch = curl_init("https://carteira.nevermissapps.com/v1/withdrawals/$txid");

curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer SUA_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

print_r($data['withdrawal']);
?>

{
  "success": true,
  "withdrawal": {
    "txid": "WD1732543800ABC",
    "amount": 500.00,
    "netAmount": 496.50,
    "fee": 3.50,
    "status": "completed",
    "paymentType": "turbo",
    "pixKey": "[email protected]",
    "pixKeyType": "EMAIL",
    "bankName": "Nubank",
    "accountHolder": "Empresa LTDA",
    "transferId": "TRF123456789",
    "isTurbo": true,
    "requestedAt": "2025-11-25T15:30:00.000Z",
    "scheduledFor": null,
    "completedAt": "2025-11-25T15:30:15.000Z",
    "failedAt": null,
    "failReason": null,
    "metadata": {
      "transfeera_transfer_id": "TRF123456789",
      "transfeera_batch_id": "BATCH789",
      "frozenBalance": 0,
      "balanceAlreadyDeducted": true
    },
    "createdAt": "2025-11-25T15:30:00.000Z",
    "updatedAt": "2025-11-25T15:30:15.000Z"
  },
  "transferStatus": {
    "status": "completed",
    "lastStatus": "processing",
    "provider": "transfeera"
  }
}

{
  "success": true,
  "withdrawal": {
    "txid": "WD1732457400XYZ",
    "amount": 250.00,
    "netAmount": 249.50,
    "fee": 0.50,
    "status": "scheduled",
    "paymentType": "normal",
    "pixKey": "[email protected]",
    "pixKeyType": "EMAIL",
    "bankName": null,
    "accountHolder": null,
    "transferId": null,
    "isTurbo": false,
    "requestedAt": "2025-11-24T15:30:00.000Z",
    "scheduledFor": "2025-11-25T15:30:00.000Z",
    "completedAt": null,
    "failedAt": null,
    "failReason": null,
    "metadata": {
      "frozenBalance": 0
    },
    "createdAt": "2025-11-24T15:30:00.000Z",
    "updatedAt": "2025-11-24T15:30:00.000Z"
  },
  "transferStatus": null
}

{
  "success": true,
  "withdrawal": {
    "txid": "WD1732370000DEF",
    "amount": 100.00,
    "netAmount": 96.50,
    "fee": 3.50,
    "status": "failed",
    "paymentType": "turbo",
    "pixKey": "[email protected]",
    "pixKeyType": "EMAIL",
    "bankName": null,
    "accountHolder": null,
    "transferId": "TRF987654321",
    "isTurbo": true,
    "requestedAt": "2025-11-23T15:06:40.000Z",
    "scheduledFor": null,
    "completedAt": null,
    "failedAt": "2025-11-23T15:07:40.000Z",
    "failReason": "Chave PIX inválida ou não encontrada",
    "metadata": {
      "transfeera_transfer_id": "TRF987654321",
      "error_code": "PIX_KEY_NOT_FOUND"
    },
    "createdAt": "2025-11-23T15:06:40.000Z",
    "updatedAt": "2025-11-23T15:07:40.000Z"
  },
  "transferStatus": {
    "status": "failed",
    "lastStatus": "processing",
    "provider": "transfeera"
  }
}

{
  "success": false,
  "message": "Saque não encontrado ou não pertence a este usuário"
}

Entendendo os Status

scheduled

Saque Normal agendadoO saque foi solicitado e está aguardando o processamento em até 24 horas. O campo scheduledFor indica quando será processado.

processing

Saque Turbo em processamentoO saque turbo foi enviado para a processadora e está sendo executado. Normalmente leva poucos segundos.

completed

Saque concluídoO valor foi transferido com sucesso para sua chave PIX. O campo completedAt indica quando foi concluído.

failed

Saque falhouOcorreu um erro no processamento. Verifique o campo failReason para entender o motivo. O valor é devolvido ao seu saldo.

cancelled

Saque canceladoO saque foi cancelado antes de ser processado. O valor é devolvido ao seu saldo.

Acompanhando Saques

async function trackWithdrawal(txid) {
  const response = await fetch(
    `https://carteira.nevermissapps.com/v1/withdrawals/${txid}`,
    { headers: { 'Authorization': `Bearer ${API_KEY}` } }
  );
  
  const { withdrawal, transferStatus } = await response.json();
  
  switch (withdrawal.status) {
    case 'scheduled':
      const scheduledDate = new Date(withdrawal.scheduledFor);
      console.log(`Agendado para: ${scheduledDate.toLocaleString()}`);
      break;
      
    case 'processing':
      console.log('Processando transferência...');
      break;
      
    case 'completed':
      console.log(`Concluído! Valor: R$ ${withdrawal.netAmount.toFixed(2)}`);
      console.log(`Banco: ${withdrawal.bankName}`);
      break;
      
    case 'failed':
      console.error(`Falhou: ${withdrawal.failReason}`);
      console.log('O valor foi devolvido ao seu saldo.');
      break;
  }
  
  return withdrawal;
}

Saques turbo: Para saques turbo, o transferStatus contém informações em tempo real da processadora. Você pode usar isso para acompanhar o progresso da transferência.

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

Path Parameters

Headers

Response

Entendendo os Status

Acompanhando Saques

​Descrição

​Path Parameters

​Headers

​Response

​Entendendo os Status

​Acompanhando Saques

Descrição

Path Parameters

Headers

Response

Entendendo os Status

Acompanhando Saques