ZypfyDocs Acessar painel
Saques Cripto

Criar saque cripto

POSThttps://api.zypfy.com/api/withdrawals/crypto/withdraw

Cria uma solicitação de saque em criptomoeda. Mesmo padrão de segurança do saque PIX:

Moeda e rede: envie apenas coin; a rede é fixa por moeda (ver GET /api/withdrawals/crypto/config). O wallet deve ser um endereço válido para a moeda (ex.: usdt/eth = 0x… 40 hex; btc = bc1…/1…/3…; sol = base58; xmr = começa com 4 ou 8).

Taxas e valores são calculados no servidor a partir do amount (BRL bruto). Não envie fee, total, coin_amount nem fee_percent — o payload é rejeitado (400) se contiver esses campos.

Fluxo: o saque é criado como PENDING e enviado à rede após aprovação interna; a conclusão (COMPLETED/FAILED) chega pelo webhook e pode ser consultada em GET /api/transactions/withdraw.

Corpo da requisição

Respostas

200Replay idempotente — external_id já usado; devolve o saque existente.
  • messagestring
    exemplo: Crypto withdrawal request received. Awaiting approval.
  • withdrawalobject
    campos de withdrawal
    • transaction_idstring
      exemplo: b2c3d4e5f6a789012345678901234567
    • external_idstring | null
      exemplo: cw-0001
    • statusstring

      Criado como PENDING; confirma por webhook.

      valores: PENDING PROCESSING COMPLETED FAILED
      exemplo: PENDING
    • amountnumber (float)

      BRL bruto debitado.

      exemplo: 200
    • feenumber (float)

      Taxa total (fixa + percentual) em BRL.

      exemplo: 9
    • totalnumber (float)

      Total debitado (= amount).

      exemplo: 200
    • coinstring
      exemplo: usdt
    • networkstring
      exemplo: BNB Smart Chain (BEP20)
    • coin_amountnumber (float) | null

      Estimativa entregue na moeda.

      exemplo: 34.512
    • walletstring
      exemplo: 0x1234567890abcdef1234567890abcdef12345678
201Saque cripto criado (PENDING), aguardando aprovação/envio.
  • messagestring
    exemplo: Crypto withdrawal request received. Awaiting approval.
  • withdrawalobject
    campos de withdrawal
    • transaction_idstring
      exemplo: b2c3d4e5f6a789012345678901234567
    • external_idstring | null
      exemplo: cw-0001
    • statusstring

      Criado como PENDING; confirma por webhook.

      valores: PENDING PROCESSING COMPLETED FAILED
      exemplo: PENDING
    • amountnumber (float)

      BRL bruto debitado.

      exemplo: 200
    • feenumber (float)

      Taxa total (fixa + percentual) em BRL.

      exemplo: 9
    • totalnumber (float)

      Total debitado (= amount).

      exemplo: 200
    • coinstring
      exemplo: usdt
    • networkstring
      exemplo: BNB Smart Chain (BEP20)
    • coin_amountnumber (float) | null

      Estimativa entregue na moeda.

      exemplo: 34.512
    • walletstring
      exemplo: 0x1234567890abcdef1234567890abcdef12345678
400Dados inválidos.
  • messagestring
  • codestring
  • detected_ipstring | null

    Presente quando code=UNAUTHORIZED_IP (IP a liberar na whitelist).

  • availablenumber (float) | null

    Presente em INSUFFICIENT_BALANCE.

  • requirednumber (float) | null

    Presente em INSUFFICIENT_BALANCE.

  • limitnumber (float) | null

    Presente em CRYPTO_DAILY_LIMIT.

  • used_24hnumber (float) | null

    Presente em CRYPTO_DAILY_LIMIT.

  • remainingnumber (float) | null

    Presente em CRYPTO_DAILY_LIMIT.

401Não autenticado.
  • messagestring

    Mensagem humana descrevendo o erro.

    exemplo: Invalid amount.
  • codestring | null

    Código opcional de erro para roteamento no seu sistema.

  • min_amountnumber (float) | null

    Presente em erros de valor abaixo do mínimo configurado.

  • max_amountnumber (float) | null

    Presente em erros de valor acima do máximo absoluto.

  • limitnumber (float) | null

    Presente em erros de limite diário por transação excedido.

  • retry_after_secondsinteger | null

    Presente em erros WITHDRAWAL_COOLDOWN / 429.

403IP não autorizado, saques bloqueados, moeda desabilitada ou limite diário.
  • messagestring
  • codestring
  • detected_ipstring | null

    Presente quando code=UNAUTHORIZED_IP (IP a liberar na whitelist).

  • availablenumber (float) | null

    Presente em INSUFFICIENT_BALANCE.

  • requirednumber (float) | null

    Presente em INSUFFICIENT_BALANCE.

  • limitnumber (float) | null

    Presente em CRYPTO_DAILY_LIMIT.

  • used_24hnumber (float) | null

    Presente em CRYPTO_DAILY_LIMIT.

  • remainingnumber (float) | null

    Presente em CRYPTO_DAILY_LIMIT.

409external_id duplicado (corrida concorrente).
  • messagestring
  • codestring
  • detected_ipstring | null

    Presente quando code=UNAUTHORIZED_IP (IP a liberar na whitelist).

  • availablenumber (float) | null

    Presente em INSUFFICIENT_BALANCE.

  • requirednumber (float) | null

    Presente em INSUFFICIENT_BALANCE.

  • limitnumber (float) | null

    Presente em CRYPTO_DAILY_LIMIT.

  • used_24hnumber (float) | null

    Presente em CRYPTO_DAILY_LIMIT.

  • remainingnumber (float) | null

    Presente em CRYPTO_DAILY_LIMIT.

502Cotação indisponível no momento (provedor).
  • messagestring

    Mensagem humana descrevendo o erro.

    exemplo: Invalid amount.
  • codestring | null

    Código opcional de erro para roteamento no seu sistema.

  • min_amountnumber (float) | null

    Presente em erros de valor abaixo do mínimo configurado.

  • max_amountnumber (float) | null

    Presente em erros de valor acima do máximo absoluto.

  • limitnumber (float) | null

    Presente em erros de limite diário por transação excedido.

  • retry_after_secondsinteger | null

    Presente em erros WITHDRAWAL_COOLDOWN / 429.