Buscar saque por ID
Saques
Buscar saque por ID
Retorna um saque com o histórico de status por que ele passou.
GET
Buscar saque por ID
GET /withdrawals/:id
Faz parte do recurso Saques — os estados e o fluxo de aprovação estão lá.
Devolve o saque completo, incluindo o statusHistory — a trilha de cada mudança de estado, com
quem a fez e quando.
O
statusHistory é onde está o “por quê”. Cada entrada traz status, changedBy,
changedAt e reason. Num saque rejected ou failed, é a reason da última entrada que
explica — o objeto raiz não tem campo de motivo.paidAt é o que confirma o dinheiro. Enquanto ele for nulo, o saque não chegou à conta, mesmo
que o status já tenha avançado. É o campo a observar em conciliação.Você não precisa ficar consultando. Três eventos cobrem o ciclo —
withdrawal.requested,
withdrawal.paid e withdrawal.rejected. Assine-os em Webhooks e use esta
rota para o detalhe, não para descobrir que algo mudou.Repare que não há evento para approved, processing, cancelled nem failed: entre o pedido e
o desfecho, o silêncio é esperado.Exemplo
Resposta 200
Authorizations
API Key da Credential (gerada no Backoffice)
Path Parameters
ID do saque
Response
Dados do saque
Identificador único do registro.
Valor bruto em centavos
Moeda no padrão ISO 4217 (ex.: BRL).
Taxa em centavos
Valor líquido (amount - fee) em centavos
Situação do saque. Valores: requested, approved, processing, paid, cancelled, rejected, failed.
ID da conta bancária de destino do saque.
Data e hora em que o pagamento foi liquidado (ISO 8601).
Histórico de mudanças de status do saque.
Data e hora de criação do registro (ISO 8601).
Data e hora da última atualização do registro (ISO 8601).