Reference - Fasten Connect

You are looking at the documentation for an older version of the Stitch SDKStitch.js (v5) was recently released and is now the recommended version of the SDK.This version includes compatibility with additional runtime environments (Web, React Native, React etc), improved performance, and additional features.v5 is backwards compatible with v4 and 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 v4 or v3, you can upgrade to v5 without making any changes to your code.Older versions of the SDK 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}
    email="patient@example.com"
    debugModeEnabled
    onEventBus={(event: StitchEvent) => {
      console.log('Fasten event', event);
    }}
  />
);

string

required

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

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.

string

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

string

(Optional) The patient’s email address. When provided, Fasten Connect prepopulates email fields in the TEFCA mode page, support request form, and health system request form. The patient can edit the prepopulated value before submitting a form.

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.

string

(Optional) Prepopulate the search box with a query.

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

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.

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.

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