Architecture
How Benbase connects to your platform — system overview and data flow diagrams.
Architecture
This page shows how Benbase fits into your platform and how data flows between systems.
System Overview
Your Platform calls the Benbase API to get iframe URLs, embeds them for employers and employees, and receives data back via webhooks and postMessage events.
Native Integration Flow
When your payroll engine is supported (e.g. Check), census data syncs automatically:
API Integration Flow
When your payroll engine is not yet supported, you provide census data via API:
What Lives Where
| Component | Where it runs | What it does |
|---|---|---|
| Your Platform | Your servers | Calls Benbase API, embeds iframes, handles webhooks |
| Benbase API | embed.benbase.com/api | Returns iframe URLs, accepts census data, sends webhooks |
| Employer Flow | embed.benbase.com (iframe) | Pre-built UI for employer plan setup and management |
| Employee Flow | embed.benbase.com (iframe) | Pre-built UI for employee benefits enrollment |
| Svix | Svix cloud | Delivers webhooks from Benbase to your endpoint |
| Check (Direct only) | Check cloud | Payroll engine that Benbase syncs census data from |