Consultar Saque PIX

Endpoints de leitura para consultar saques PIX. Use GET /v1/withdraw-status/:id para detalhe de um saque específico ou GET /v1/withdraw-status para listar com filtros e paginação.

Requer chave de API com scope read. Headers Authorization, X-DF-Secret e X-DF-Passphrase são obrigatórios. Não requer X-DF-Idempotency-Key (são operações de leitura).

• Scope: read
• Rate limit: 60 req/min, burst 10/5s

Retorna detalhes de um saque específico.

curl https://api.deflow.exchange/v1/withdraw-status/67234abc \
  -H "Authorization: Bearer dfk_live_..." \
  -H "X-DF-Secret: sk_..." \
  -H "X-DF-Passphrase: minha-passphrase"

{
  "data": {
    "id": "67234abc...",
    "status": "sent",
    "pixKey": "12345678909",
    "pixKeyType": "cpf",
    "payoutAmountCents": 5000,
    "feeCents": 100,
    "depositAmountCents": 5100,
    "createdAt": "2026-05-15T12:00:00.000Z",
    "sentAt": "2026-05-15T12:01:30.000Z"
  },
  "meta": {
    "timestamp": "2026-05-15T12:02:00.000Z"
  }
}

• Scope: read
• Rate limit: 30 req/min, burst 5/5s

Lista saques da conta. Suporta filtros.

curl "https://api.deflow.exchange/v1/withdraw-status?page=1&limit=20&status=sent&from=2026-05-01T00:00:00Z&to=2026-05-15T23:59:59Z" \
  -H "Authorization: Bearer dfk_live_..." \
  -H "X-DF-Secret: sk_..." \
  -H "X-DF-Passphrase: minha-passphrase"

{
  "data": {
    "items": [
      {
        "id": "67234abc...",
        "status": "sent",
        "pixKey": "12345678909",
        "pixKeyType": "cpf",
        "payoutAmountCents": 5000,
        "feeCents": 100,
        "createdAt": "2026-05-15T12:00:00.000Z"
      }
    ],
    "page": 1,
    "limit": 20,
    "total": 1
  },
  "meta": {
    "timestamp": "2026-05-15T12:02:00.000Z"
  }
}

page (mínimo 1) e limit (1-100). Resposta inclui pagination.

• unsent — aguardando funding em DePix
• sending — envio em andamento
• sent — PIX enviado com sucesso
• error — falha irreversível
• cancelled — cancelado manualmente
• refunded — estornado

Webhook é primário e mais eficiente. Polling a cada 5-10s é fallback aceitável quando webhook não é viável.