Consultar saque por identificador único
https://api.zypfy.com/api/transactions/withdrawBusca um saque específico (PIX ou cripto) usando um dos parâmetros únicos abaixo. Use este endpoint para conferir o status final após um webhook de saque não chegar ou em janelas de reconciliação agendada.
Exatamente um parâmetro entre end_to_end, transaction_id,
external_id e idempotency_key deve ser informado.
Para saques cripto, a resposta traz is_crypto: true e os campos
crypto_coin, crypto_network, crypto_wallet, crypto_coin_amount e
crypto_tx_hash (hash on-chain, após liquidar).
Parâmetros de consulta
end_to_endstringEndToEnd ID do PIX.
transaction_idstringIdentificador da transação na Zypfy.
external_idstringIdentificador gerado pelo merchant na criação.
idempotency_keystringChave de idempotência persistida — normalmente igual ao
external_id, mas pode divergir em casos especiais de reprocessamento manual.
Respostas
200Transação encontrada (ou null em withdraw).
filtersobjectEcoa os filtros aplicados na busca (parâmetros não enviados vêm como
null).campos de filters
end_to_endstring | nulltransaction_idstring | nullexternal_idstring | nulltxidstring | nullidempotency_keystring | null
withdrawcampos de withdraw
typestringvalores:withdrawexemplo:withdrawidintegerexemplo:202transaction_idstringexemplo:b2c3d4e5-f6a7-8901-bcde-f23456789012end_to_end_idstring | nullexemplo:E0041696820240617152400000000002external_idstring | nullexemplo:saque-0001amountnumber (float)exemplo:50feenumber (float)exemplo:2.5totalnumber (float)exemplo:52.5statusstringvalores:PENDINGQUEUECOMPLETEDFAILEDREFUNDEDPARTIALLY_REFUNDEDexemplo:COMPLETEDreceiver_namestring | nullexemplo:João Silvareceiver_cpfstring | nullexemplo:12345678901receiver_ispbstring | nullexemplo:87654321is_cryptobooleantruequando o saque é cripto; os camposcrypto_*só aparecem nesse caso.exemplo:falsecrypto_coinstring | nullSó em saque cripto.
exemplo:usdtcrypto_networkstring | nullSó em saque cripto.
exemplo:BNB Smart Chain (BEP20)crypto_walletstring | nullEndereço de destino (só cripto).
exemplo:0x1234567890abcdef1234567890abcdef12345678crypto_coin_amountnumber (float) | nullQuantidade na moeda (só cripto).
exemplo:34.512crypto_tx_hashstring | nullHash on-chain (só cripto, após liquidar).
exemplo:0xabc123...defcreated_atstring (date-time)exemplo:2026-04-18T12:05:00.000Z
400Nenhum parâmetro único fornecido.
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.
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.