General

All Tesser webhook events share a common envelope structure. The envelope wraps event-specific data in a consistent format so your handler can route and process events uniformly.

Envelope Fields

Event Type Format

Event types follow the pattern scope.action. Current scopes are payment, deposit, withdrawal, and step. See Payment Updates and Treasury Updates for event details.

Example Payload

Code
 
{
  "id": "event_111",
  "type": "payment.quote_created",
  "created_at": "2025-12-01T09:00:00.045Z",
  "data": {
    "object": {
      "id": "550e8400-e29b-41d4-a716-446655440020",
      "workspace_id": "550e8400-e29b-41d4-a716-446655440001",
      "organization_reference_id": "ref_123",
      "direction": "outbound",
      "source_account_id": null,
      "originator_account_id": null,
      "beneficiary_account_id": null,
      "from_amount": "55.85",
      "from_currency": "USDC",
      "from_network": null,
      "to_amount": "1000",
      "to_currency": "MXN",
      "to_network": null,
      "risk_status": "unchecked",
      "risk_status_reasons": [],
      "risk_reviewed_by": null,
      "risk_reviewed_at": null,
      "balance_status": "unreserved",
      "balance_reserved_at": null,
      "steps": [],
      "created_at": "2025-12-01T09:00:00.000Z",
      "updated_at": "2025-12-01T09:00:00.040Z",
      "expires_at": "2025-12-01T23:59:59.999Z"
    }
  }
}