Webhooks
Payload
Campos e cabeçalhos do evento transaction.paid.
{
"event": "transaction.paid",
"transactionId": "TRANSACTION_ID",
"externalRef": "PROVIDER_REFERENCE",
"amount": 25,
"netAmount": 24,
"tax": 1,
"status": "PAID",
"type": "DEPOSIT",
"confirmed_date": "2026-10-04 12:00:00"
}externalRef vem da referência do provedor e pode ser nulo. DEPOSIT inclui netAmount e tax; WITHDRAW omite ambos. A tarifa do exemplo é ilustrativa, não uma promessa de preço. confirmed_date é uma data legada no fuso America/Sao_Paulo. O payload da fila de saída v3 não tem campo de ambiente; diferencie o sandbox pela credencial/receptor e confirme pelo caminho de consulta correspondente.
Headers, cujos nomes não diferenciam maiúsculas de minúsculas:
- Content-Type: application/json
- User-Agent: QuiblyPay-Webhook/1.0
- X-Quibly-Secret: segredo do webhook, somente para o destino que o possui; veja as regras de entrega
- X-Quibly-Signature:
sha256=<64 caracteres hexadecimais minúsculos> - X-Quibly-Timestamp: horário Unix em segundos
- X-Quibly-Delivery: ID da entrega
- X-Quibly-Event-Id:
evt_<ID da entrega>, estável entre retentativas