Preloader
Desenvolvedor

Webhook transacional

A PulsePag envia eventos transacionais para a URL informada em projectWebhook ou clientCallbackUrl. A rota abaixo é documentativa e representa o payload que o seu sistema deve receber.

Endpoint documentado: POST /webhooks/transaction-status
Headers de assinatura
X-PulsePag-Webhook-Timestamp: 1713096000
X-PulsePag-Webhook-Signature: HEX_HMAC_SHA256

Assinatura esperada: hex(hmac_sha256(client_secret, timestamp + "." + raw_body_json))

Payload esperado
{
  "transaction_id": "pedido-123",
  "external_id": "pedido-123",
  "status": "COMPLETED",
  "amount": 5,
  "fee": 0,
  "total": 5,
  "type": "Deposit",
  "provider": "gateway-name",
  "event": "transaction.status.updated"
}
Boa prática
  • Responda HTTP 200 rapidamente.
  • Implemente idempotência usando transaction_id.
  • Guarde payload bruto para auditoria.