Titus Webhooks

generated: '2026-10-29'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.gotitus.com/guide/developer-resources/webhooks/index.md
sources:
- https://docs.gotitus.com/guide/developer-resources/webhooks/index.md
- https://docs.gotitus.com/guide/developer-resources/webhooks
description: Titus webhook events are sent as POST requests with a JSON payload and include a signature for verification.
events:
- event: authorization.loan_application_denied
  description: Sent when a customer's pay‑at‑close application is declined and the application started from an authorization.
- event: checkout.loan_application_denied
  description: Sent when a customer's pay‑at‑close application is declined and the application started from a checkout.
- event: checkout.loan_application_under_review
  description: Sent when an application that started from a checkout goes to manual review.
- event: checkout.loan_application_approved
  description: Sent when an application that started from a checkout is approved.
- event: checkout.payment_failed
  description: Sent alongside `checkout.updated` when a payment fails after being accepted for processing, causing the checkout to return to `requires-payment`.
delivery:
  signature: HMAC SHA-256 of `${timestamp}.${body}`
  retries: Exponential backoff with a maximum number of attempts (unspecified); retries occur on non‑2xx responses, timeouts, or connection failures;
    delivery order is not guaranteed; endpoint must be idempotent.
note: All webhook requests include the headers `x-webhook-signature` and `x-webhook-timestamp`.
docs: https://docs.gotitus.com/guide/developer-resources/webhooks/index.md