Webhooks
Webhook: saque cripto (enviado pela Zypfy ao seu servidor)
POST
https://seusite.com/webhooks/zypfysua URL de callback (clientCallbackUrl ou a configurada no painel)Este endpoint é hospedado pelo seu servidor, não pela Zypfy.
A Zypfy faz POST para a clientCallbackUrl do saque cripto (ou para a
URL de webhook de saque configurada no portal) quando o saque atinge
estado final (COMPLETED/FAILED). O payload tem type: "CryptoWithdrawal"
e inclui coin, network, coin_amount e tx_hash (hash on-chain).
Assinatura idêntica à dos demais webhooks: X-Webhook-Signature +
X-Webhook-Timestamp (HMAC-SHA256 de ${timestamp}.${corpo_bruto}).
Em falha, há reenvio automático (até 3 tentativas). Sempre confirme
contra GET /api/transactions/withdraw em caso de dúvida.
Corpo da requisição
typestringexemplo:CryptoWithdrawaltransaction_idstringexemplo:b2c3d4e5f6a789012345678901234567external_idstring | nullexemplo:cw-0001statusstringvalores:COMPLETEDFAILEDamountnumber (float)exemplo:200feenumber (float)exemplo:9totalnumber (float)exemplo:200coinstring | nullexemplo:usdtnetworkstring | nullexemplo:BNB Smart Chain (BEP20)coin_amountnumber (float) | nullQuantidade efetivamente entregue (null em falha).
exemplo:34.512tx_hashstring | nullHash on-chain da transferência (null até liquidar).
exemplo:0xabc123...defwalletstring | nullexemplo:0x1234567890abcdef1234567890abcdef12345678error_messagestring | nullPresente quando
status=FAILED.