Buscar Saque

Utilize este endpoint para buscar um saque específico pelo id.

Ambientes Disponíveis

Produção

https://api.unoip.com.br

Endpoint

• Método: GET
• Endpoint: /withdrawal/{id}
• Autenticação: Bearer token

Path Params

Nome	Tipo	Obrigatório	Descrição	Validações
id	string (UUID)	Sim	Identificador do saque	Deve ser UUID válido

Exemplo de Requisição

cURL

curl --request GET \
--url https://api.unoip.com..br/withdrawal/553e8400-e29b-41d4-a716-436251480000 \
--header 'Authorization: Bearer seu-token-jwt'

JavaScript

const response = await fetch('https://api.unoip.com..br/withdrawal/553e8400-e29b-41d4-a716-436251480000', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer seu-token-jwt'
  }
});
const data = await response.json();

Resposta de Sucesso

Campo	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	Identificador único do saque
acquirer	string	Sim	Adquirente do saque
amount	number	Sim	Valor do saque (inteiro em centavos)
method	string (enum) - PIX	Sim	Método do saque
webhookUrl	string	Não	URL de webhook configurada
externalCode	string	Não	Seu código de referência
createdAt	string (ISO)	Sim	Data de criação
status	string (enum) - PENDING, PROCESSING, PROCESSED, FAILED, CANCELED, REFUNDED, REJECTED	Sim	PENDING: Saque criado, aguardando processamento PROCESSING: Saque em processamento PROCESSED: Saque processado com sucesso FAILED: Erro no processamento CANCELED: Saque cancelado REFUNDED: Saque estornado REJECTED: Saque rejeitado pela gateway
statusHistory	array	Sim	Histórico de status (ver Sub-Objetos StatusHistory)
updatedAt	string (ISO)	Sim	Data da última atualização
amountWithdrawn	number	Não	Valor efetivamente sacado
processedDate	string (ISO)	Não	Data de processamento
errorMessage	string	Não	Mensagem de erro
endToEnd	string	Não	Identificador end-to-end do saque
payer	object	Não	Dados do pagador (ver Sub-Objetos AccountHolder)
receiver	object	Não	Dados do recebedor (ver Sub-Objetos AccountHolder)
pixKey	object	Não	Dados da chave PIX (ver Sub-Objetos PixKeyVo)
feeAmount	number	Não	Valor da taxa

Sub-Objetos

StatusHistory (item)

Campo	Tipo	Obrigatório	Descrição
status	string (enum) - PENDING, PROCESSING, PROCESSED, FAILED, CANCELED, REFUNDED, REJECTED	Sim	Status do saque
date	string (ISO)	Sim	Data do status
durationInMilliseconds	number	Sim	Duração do status em milissegundos

AccountHolder

Campo	Tipo	Obrigatório	Descrição
type	string (enum) - PF, PJ	Sim	Tipo do titular
name	string	Sim	Nome do titular
document	string	Sim	Documento do titular
bankAccount	object	Sim	Dados bancários (ver Sub-Objetos BankAccount)
pix	object	Sim	Chave PIX do titular (ver Sub-Objetos PixKeyVo)

BankAccount

Campo	Tipo	Obrigatório	Descrição
type	string	Sim	Tipo de conta
branch	string	Sim	Agência
number	string	Sim	Número da conta
digit	string	Sim	Dígito da conta
ispb	string	Sim	ISPB do banco

PixKeyVo

Campo	Tipo	Obrigatório	Descrição
key	string	Sim	Chave PIX
type	string (enum) - CPF, CNPJ, EMAIL, PHONE, EVP	Sim	Tipo da chave PIX

Exemplo de Resposta

{
  "id": "553e8400-e29b-41d4-a716-436251480000",
  "acquirer": "UNOIP",
  "amount": 10000,
  "method": "PIX",
  "webhookUrl": "https://sua-api.com/webhooks/withdrawal",
  "externalCode": "SAQUE-123",
  "createdAt": "2026-03-06T12:49:04.681Z",
  "status": "PROCESSED",
  "statusHistory": [
    {
      "status": "PENDING",
      "date": "2026-03-06T12:49:04.681Z",
      "durationInMilliseconds": 1000
    },
    {
      "status": "PROCESSING",
      "date": "2026-03-06T12:49:04.681Z",
      "durationInMilliseconds": 10000
    },
    {
      "status": "PROCESSED",
      "date": "2026-03-06T12:49:04.681Z",
      "durationInMilliseconds": null
    }
  ],
  "updatedAt": "2026-03-06T12:49:04.681Z",
  "amountWithdrawn": 10000,
  "processedDate":  "2026-03-06T12:49:04.681Z",
  "errorMessage": null,
  "endToEnd": "0123456789",
  "payer": {
    "type": "PF",
    "name": "Fulano de Tal",
    "document": "12345678910",
    "bankAccount": {
      "type": "CHECKING",
      "branch": "0001",
      "number": "123456",
      "digit": "7",
      "ispb": "12345678"
    },
    "pix": {
      "key": "12345678910",
      "type": "CPF"
    }
  },
  "receiver": {
    "type": "PJ",
    "name": "Empresa Exemplo LTDA",
    "document": "12345678000199",
    "bankAccount": {
      "type": "CHECKING",
      "branch": "0001",
      "number": "654321",
      "digit": "0",
      "ispb": "12345678"
    },
    "pix": {
      "key": "contato@exemplo.com",
      "type": "EMAIL"
    }
  },
  "pixKey": {
    "key": "12345678910",
    "type": "CPF"
  },
  "feeAmount": 150
}

Possíveis Erros

Código	Descrição	Solução
401	Credenciais inválidas	Verifique suas credenciais
403	Sem permissão/autorização	Contate o suporte
404	Registro não encontrado	Verifique o id informado
422	Dados inválidos ou faltando	Verifique o formato dos dados
422	Validações	Contate o suporte
500	Erro interno	Contate o suporte