InsuranceCard
ComplexRevenue
<co-insurance-card>InsuranceCard shows the front and back of a member card with the fields billing needs and the scan state.
import { InsuranceCard } from 'health-components';
Examples
Front And Back
Not Scanned
Back
Usage
<InsuranceCard payer="Aetna" plan="Open Access PPO" memberId="W123456789" scanned="10/09/2026" />
When to use
- Check-in and coverage review.
When not to use
- Coverage order: CoverageStack.
Variants and states
| Variant | What it is |
|---|---|
| front / back | Toggle. |
| scanned | Badge with date, or Scan Card. |
Accessibility
- role group labelled with payer and side, so the typed fields stay readable by screen readers.
Do and don't
- Do: Show the payer ID for claims.
- Don't: Show a card image without the typed fields.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
payer | string | none | Payer name, e.g. "Aetna" (front) |
plan | string | none | Plan name, e.g. "Open Access PPO" (front) |
member | string | none | Member name as printed on the card (front) |
memberId | string | none | Member ID (front) |
group | string | none | Group number (front) |
copay | string | none | Copay line, e.g. "PCP $25 . Spec $50" (front) |
rx | string | none | Rx BIN / PCN (front) |
payerId | string | none | Payer ID for electronic claims (back) |
claimsAddress | string | none | Where claims go (back) |
phone | string | none | Provider services phone line (back) |
precert | string | none | Pre-certification rule or phone (back) |
side | InsuranceCardSide | undefined (uncontrolled) | Controlled side shown: 'front' | 'back' |
defaultSide | InsuranceCardSide | 'front' | Initial side when uncontrolled |
onSideChange | (side: InsuranceCardSide) => void | — | Called when the user flips the card |
scanned | string | none | Scan date; shows a Scanned badge instead of the Scan Card button |
onScan | (event: MouseEvent<HTMLButtonElement>) => void | none | Called when Scan Card is pressed |
Also accepts native attributes, including defaultChecked, defaultValue, autoFocus, plus className and event handlers on the root element.
Angular, Vue and HTML
Register the elements once (Angular guide), then use <co-insurance-card>. Attributes take strings; arrays and objects are set as properties (Angular [prop], Vue :prop) or as JSON attributes. Callbacks are DOM events with the value in event.detail.
Angular template
<co-insurance-card payer="…" plan="…" [defaultValue]="defaultValue" (co-side-change)="onSideChange($event.detail)"></co-insurance-card>
| Kind | Name | Description |
|---|---|---|
| attribute | payer | Payer name, e.g. "Aetna" (front); default none |
| attribute | plan | Plan name, e.g. "Open Access PPO" (front); default none |
| attribute | member | Member name as printed on the card (front); default none |
| attribute | member-id / memberId | Member ID (front); default none |
| attribute | group | Group number (front); default none |
| attribute | copay | Copay line, e.g. "PCP $25 . Spec $50" (front); default none |
| attribute | rx | Rx BIN / PCN (front); default none |
| attribute | payer-id / payerId | Payer ID for electronic claims (back); default none |
| attribute | claims-address / claimsAddress | Where claims go (back); default none |
| attribute | phone | Provider services phone line (back); default none |
| attribute | precert | Pre-certification rule or phone (back); default none |
| attribute | side | Controlled side shown: 'front' | 'back'; default undefined (uncontrolled) |
| attribute | default-side / defaultSide | Initial side when uncontrolled; default 'front' |
| attribute | scanned | Scan date; shows a Scanned badge instead of the Scan Card button; default none |
| attribute | default-checked / defaultChecked | |
| property / JSON attribute | default-value / defaultValue | |
| attribute | auto-focus / autoFocus | |
| event | co-side-change | Called when the user flips the card (React: onSideChange) |
| event | co-scan | Called when Scan Card is pressed; default none (React: onScan) |