Integrations

Integration Pattern

External providers are handled through async-friendly connector contracts. Request-path coupling is minimized by tracking outbound/inbound events with retries and dedupe protections.

Stripe

• Webhook signature verification for inbound events.
• Deduplication by provider event ID with replay-safe handling.
• Outbox event creation for downstream processing and retry visibility.
• Sync status and failed-event visibility through API integration endpoints.

QuickBooks

• Connector model supports account mapping and transaction sync tracking.
• Webhook receipt records preserve raw payload and validation status.
• External object mapping enables reconciliation between local and provider IDs.
• Sync errors are surfaced for operational follow-up and replay.

Thumbtack Compatibility Prep

• Workspace connections now support the thumbtack provider key.
• OAuth start/callback endpoints persist provider tokens on integration connections.
• One API call can hire a marketplace vendor and assign them to a local work order.
• Vendor membership roles are synchronized to include baseline and service-line access.
• Outbox worker command replays vendor.hire_assign events with retry/backoff semantics.

Operational Files

• docs/integrations/stripe.md
• docs/integrations/quickbooks.md
• docs/integrations/thumbtack.md
• backend/apps/core/api/integrations.py
• backend/apps/core/models.py integration models