ZypfyDocs Acessar painel
Webhooks

Webhook: saque (enviado pela Zypfy ao seu servidor)

POSThttps://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 URL configurada em clientCallbackUrl do request de saque ou para a URL global configurada no portal, quando o status do saque muda.

Use o transaction_id (ou external_id se você mantiver o mapeamento) para localizar o saque no seu sistema. Sempre confirme contra GET /api/transactions/withdraw se houver dúvida.

Os webhooks de saque também incluem X-Webhook-Signature e X-Webhook-Timestamp e devem ser validados da mesma forma descrita no webhook de depósito (HMAC-SHA256 de ${timestamp}.${corpo_bruto}).

Corpo da requisição

Respostas

200Seu servidor responde 2xx para confirmar o recebimento.