Criar saque cripto
https://api.zypfy.com/api/withdrawals/crypto/withdrawCria uma solicitação de saque em criptomoeda. Mesmo padrão de segurança do saque PIX:
- Whitelist de IP obrigatória para token de integrador (login com
client_id/client_secret) — o IP de origem precisa estar liberado no dashboard (mesma whitelist do saque PIX). IP fora da lista →403. - Idempotência por
external_id(único por conta). Repetir o mesmoexternal_iddevolve o saque já criado (HTTP 200); corrida concorrente com o mesmoexternal_id→409. - Sem PIN para token de integrador (a autorização é IP + JWT). Já um
token de sessão de usuário (login com e-mail/senha, usado pela dashboard
e pelo app) autoriza pelo campo
transaction_pinno body quando o IP não está na whitelist — rede móvel troca de IP a cada reconexão. Aplicativos devem usarPOST /api/app/withdraw/crypto, que exige o PIN sempre. clientCallbackUrl(HTTPS) opcional recebe o webhook de conclusão. Se omitido, usa a URL de webhook de saque configurada no portal.
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
amountnumber (float)obrigatórioValor bruto em BRL a debitar. Taxas são descontadas no servidor.
exemplo:200mín. 0.01external_idstringobrigatórioIdentificador único do seu lado (idempotency key). Único por conta.
exemplo:cw-0001coinstringobrigatórioMoeda do saque. A rede é fixa por moeda (não é escolhível):
usdt→ BNB Smart Chain (BEP20)btc→ Bitcoineth→ Ethereumsol→ Solanaxmr→ Monero
valores:usdtbtcethsolxmrexemplo:usdtwalletstringobrigatórioEndereço de destino, válido para a moeda:
usdt/eth— EVM0x…(40 hex)btc—bc1…/1…/3…sol— base58 (32–44 chars)xmr— começa com4ou8
exemplo:0x1234567890abcdef1234567890abcdef12345678clientCallbackUrlstring (uri) | nullURL HTTPS para o webhook de conclusão deste saque. Opcional.
exemplo:https://minhaloja.com/webhooks/crypto-withdrawal
Respostas
200Replay idempotente — external_id já usado; devolve o saque existente.
messagestringexemplo:Crypto withdrawal request received. Awaiting approval.withdrawalobjectcampos de withdrawal
transaction_idstringexemplo:b2c3d4e5f6a789012345678901234567external_idstring | nullexemplo:cw-0001statusstringCriado como
PENDING; confirma por webhook.valores:PENDINGPROCESSINGCOMPLETEDFAILEDexemplo:PENDINGamountnumber (float)BRL bruto debitado.
exemplo:200feenumber (float)Taxa total (fixa + percentual) em BRL.
exemplo:9totalnumber (float)Total debitado (= amount).
exemplo:200coinstringexemplo:usdtnetworkstringexemplo:BNB Smart Chain (BEP20)coin_amountnumber (float) | nullEstimativa entregue na moeda.
exemplo:34.512walletstringexemplo:0x1234567890abcdef1234567890abcdef12345678
201Saque cripto criado (PENDING), aguardando aprovação/envio.
messagestringexemplo:Crypto withdrawal request received. Awaiting approval.withdrawalobjectcampos de withdrawal
transaction_idstringexemplo:b2c3d4e5f6a789012345678901234567external_idstring | nullexemplo:cw-0001statusstringCriado como
PENDING; confirma por webhook.valores:PENDINGPROCESSINGCOMPLETEDFAILEDexemplo:PENDINGamountnumber (float)BRL bruto debitado.
exemplo:200feenumber (float)Taxa total (fixa + percentual) em BRL.
exemplo:9totalnumber (float)Total debitado (= amount).
exemplo:200coinstringexemplo:usdtnetworkstringexemplo:BNB Smart Chain (BEP20)coin_amountnumber (float) | nullEstimativa entregue na moeda.
exemplo:34.512walletstringexemplo:0x1234567890abcdef1234567890abcdef12345678
400Dados inválidos.
messagestringcodestringdetected_ipstring | nullPresente quando
code=UNAUTHORIZED_IP(IP a liberar na whitelist).availablenumber (float) | nullPresente em INSUFFICIENT_BALANCE.
requirednumber (float) | nullPresente em INSUFFICIENT_BALANCE.
limitnumber (float) | nullPresente em CRYPTO_DAILY_LIMIT.
used_24hnumber (float) | nullPresente em CRYPTO_DAILY_LIMIT.
remainingnumber (float) | nullPresente em CRYPTO_DAILY_LIMIT.
401Não autenticado.
messagestringMensagem humana descrevendo o erro.
exemplo:Invalid amount.codestring | nullCódigo opcional de erro para roteamento no seu sistema.
min_amountnumber (float) | nullPresente em erros de valor abaixo do mínimo configurado.
max_amountnumber (float) | nullPresente em erros de valor acima do máximo absoluto.
limitnumber (float) | nullPresente em erros de limite diário por transação excedido.
retry_after_secondsinteger | nullPresente em erros
WITHDRAWAL_COOLDOWN/ 429.
403IP não autorizado, saques bloqueados, moeda desabilitada ou limite diário.
messagestringcodestringdetected_ipstring | nullPresente quando
code=UNAUTHORIZED_IP(IP a liberar na whitelist).availablenumber (float) | nullPresente em INSUFFICIENT_BALANCE.
requirednumber (float) | nullPresente em INSUFFICIENT_BALANCE.
limitnumber (float) | nullPresente em CRYPTO_DAILY_LIMIT.
used_24hnumber (float) | nullPresente em CRYPTO_DAILY_LIMIT.
remainingnumber (float) | nullPresente em CRYPTO_DAILY_LIMIT.
409external_id duplicado (corrida concorrente).
messagestringcodestringdetected_ipstring | nullPresente quando
code=UNAUTHORIZED_IP(IP a liberar na whitelist).availablenumber (float) | nullPresente em INSUFFICIENT_BALANCE.
requirednumber (float) | nullPresente em INSUFFICIENT_BALANCE.
limitnumber (float) | nullPresente em CRYPTO_DAILY_LIMIT.
used_24hnumber (float) | nullPresente em CRYPTO_DAILY_LIMIT.
remainingnumber (float) | nullPresente em CRYPTO_DAILY_LIMIT.
502Cotação indisponível no momento (provedor).
messagestringMensagem humana descrevendo o erro.
exemplo:Invalid amount.codestring | nullCódigo opcional de erro para roteamento no seu sistema.
min_amountnumber (float) | nullPresente em erros de valor abaixo do mínimo configurado.
max_amountnumber (float) | nullPresente em erros de valor acima do máximo absoluto.
limitnumber (float) | nullPresente em erros de limite diário por transação excedido.
retry_after_secondsinteger | nullPresente em erros
WITHDRAWAL_COOLDOWN/ 429.