Webhooks
Webhook: saque (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 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
typestringvalores:Withdrawalexemplo:Withdrawaltransaction_idstringexemplo:b2c3d4e5-f6a7-8901-bcde-f23456789012statusstringvalores:PENDINGQUEUEPROCESSINGCOMPLETEDFAILEDREFUNDEDPARTIALLY_REFUNDEDamountnumber (float)exemplo:50totalnumber (float)exemplo:52.5feenumber (float)exemplo:2.5end_to_end_idstring | nullexemplo:E0041696820240617152400000000002receiver_namestring | nullexemplo:João Silvareceiver_cpfstring | nullexemplo:12345678901receiver_ispbstring | nullexemplo:87654321error_codestring | nullPresente apenas em
FAILED.error_messagestring | nullPresente apenas em
FAILED.