Quibly Pay
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