Skip to main content

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​

Storybook

Not Scanned​

Storybook

Back​

Storybook

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​

VariantWhat it is
front / backToggle.
scannedBadge 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​

PropTypeDefaultDescription
payerstringnonePayer name, e.g. "Aetna" (front)
planstringnonePlan name, e.g. "Open Access PPO" (front)
memberstringnoneMember name as printed on the card (front)
memberIdstringnoneMember ID (front)
groupstringnoneGroup number (front)
copaystringnoneCopay line, e.g. "PCP $25 . Spec $50" (front)
rxstringnoneRx BIN / PCN (front)
payerIdstringnonePayer ID for electronic claims (back)
claimsAddressstringnoneWhere claims go (back)
phonestringnoneProvider services phone line (back)
precertstringnonePre-certification rule or phone (back)
sideInsuranceCardSideundefined (uncontrolled)Controlled side shown: 'front' | 'back'
defaultSideInsuranceCardSide'front'Initial side when uncontrolled
onSideChange(side: InsuranceCardSide) => void—Called when the user flips the card
scannedstringnoneScan date; shows a Scanned badge instead of the Scan Card button
onScan(event: MouseEvent<HTMLButtonElement>) => voidnoneCalled 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>
KindNameDescription
attributepayerPayer name, e.g. "Aetna" (front); default none
attributeplanPlan name, e.g. "Open Access PPO" (front); default none
attributememberMember name as printed on the card (front); default none
attributemember-id / memberIdMember ID (front); default none
attributegroupGroup number (front); default none
attributecopayCopay line, e.g. "PCP $25 . Spec $50" (front); default none
attributerxRx BIN / PCN (front); default none
attributepayer-id / payerIdPayer ID for electronic claims (back); default none
attributeclaims-address / claimsAddressWhere claims go (back); default none
attributephoneProvider services phone line (back); default none
attributeprecertPre-certification rule or phone (back); default none
attributesideControlled side shown: 'front' | 'back'; default undefined (uncontrolled)
attributedefault-side / defaultSideInitial side when uncontrolled; default 'front'
attributescannedScan date; shows a Scanned badge instead of the Scan Card button; default none
attributedefault-checked / defaultChecked
property / JSON attributedefault-value / defaultValue
attributeauto-focus / autoFocus
eventco-side-changeCalled when the user flips the card (React: onSideChange)
eventco-scanCalled when Scan Card is pressed; default none (React: onScan)