Reference - Fasten Connect

This documentation is for Stitch.js (v4) SDK, which is now the recommended version for integrating Fasten Connect into your application. If you need access to the previous versions, please see v1 documentation or v3 documentation.This version includes compatibility with additional runtime environments (Web, React Native, React etc), improved performance, and additional features.v4 is backwards compatible with v3 — there are no breaking changes to the public API, but we have made significant improvements to the underlying codebase and architecture. If you are currently using v3, you can upgrade to v4 without making any changes to your code.The v1 Web Component and v3 Web Component are in maintenance mode and will no longer receive updates (outside of security fixes). Please update your code to use the new version.

import { FastenStitchElement } from 'fasten-connect-stitch-react-native';

const CUSTOMER_PUBLIC_ID = 'public_test_...';

export const ConnectScreen = () => (
  <FastenStitchElement
    publicId={CUSTOMER_PUBLIC_ID}
    debugModeEnabled
    onEventBus={(event: StitchEvent) => {
      console.log('Fasten event', event);
    }}
  />
);

publicId

string

required

This must be your API public ID. You can find it in your Fasten Connect Portal.

reconnectOrgConnectionId

string

(Optional) Useful when the patient connection credentials are invalid (due to expiration or revocation). Providing this reconnectOrgConnectionId allows Fasten to reauthenticate the Patient and store their new credentials. Reconnect When provided, the stitch component will skip the search step and go directly to the reauthentication step for the specified organization connection.

externalId

string

(Optional) An Opaque identifier, used to identify the patient in your system. This value will be returned in the response.

searchOnly

boolean

(Optional) If set to true, the stitch component will only show the search box and will not prompt the patient to verify their email address.

searchQuery

string

(Optional) Prepopulate the search box with a query.

showSplash

boolean

(Optional) Show a splash page introduces Fasten Connect and displays your privacy policy & terms to the patient before they begin the connection process.

Show example

eventTypes

string

(Optional) By default the following standard events are always emitted:

patient.connection_pending
patient.connection_success
patient.connection_failed
widget.complete.

If you would like to receive the optional events listed below, you must set the event-types parameter to a comma-separated list of event types.

search.query: This event is emitted when the patient searches for a healthcare institution in the Fasten Connect catalog.

onEventBus

callback

(Optional/Recommended) This callback is called whenever the Stitch component emits an event. The callback receives a fully-parsed JSON object containing the event data.

tefcaMode

boolean

(Optional) If set to true, the stitch component will operate in TEFCA IAS mode, which is a streamlined experience designed to simplify medical record collection. In this mode, the patient will be able to verify their identity and pull medical records from healthcare institutions that participate in the TEFCA network, with minimal friction. See the TEFCA IAS documentation for more information on this experience and its benefits.

Events

The Stitch React Native SDK emits client-side events that can be listened to in your React Native application. The events are emitted on via the onEventBus callback you can pass to the FastenStitchElement component. The callback receives a fully-parsed JSON object containing the event data.

onEventBus={(event: StitchEvent) => {
  console.log('Fasten event', event);
}}

See the Events section of the documentation for more information on the events emitted by the Stitch SDK and their payloads.

​Events

Events