Consultar depósito por identificador único
https://api.zypfy.com/api/transactions/depositBusca um depósito específico usando um dos parâmetros únicos abaixo. Use este endpoint para reconciliar transações após falha ou atraso de webhook — a resposta reflete o estado atual no banco.
Exatamente um parâmetro entre end_to_end, transaction_id,
external_id e txid deve ser informado. Se nenhum for passado,
retorna HTTP 400.
Parâmetros de consulta
end_to_endstringEndToEnd ID do PIX (gerado pelo BACEN na liquidação).
transaction_idstringIdentificador da transação na Zypfy.
external_idstringIdentificador gerado pelo merchant na criação.
txidstringTXID EMV do QR Code.
idempotency_keystringIgnorado em depósitos (usado apenas em saques).
Respostas
200Transação encontrada (ou null em deposit se nenhum registro
bateu com os filtros).
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
depositcampos de deposit
typestringvalores:depositexemplo:depositidintegerexemplo:101transaction_idstringexemplo:a1b2c3d4-e5f6-7890-abcd-ef1234567890end_to_end_idstring | nullexemplo:E0041696820240617152400000000001external_idstring | nullexemplo:order-2026-0001txidstring | nullexemplo:TXID123ABCamountnumber (float)exemplo:100feenumber (float)exemplo:2.5totalnumber (float) | nullstatusstringvalores:PENDINGCOMPLETEDFAILEDexemplo:COMPLETEDpayer_namestring | nullexemplo:João Silvapayer_cpfstring | nullexemplo:12345678901payer_ispbstring | nullexemplo:12345678created_atstring (date-time)exemplo:2026-04-18T12:00: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.