Events

All events will have the following format, that includes a type and timestamp on the object. Certain events have a payload property with more event properties. See Specific Event Payloads for more details.

{
   type: 'payscore/incomeVerification/loaded',
   timestamp : "2011-12-19T15:28:46.493Z",
   payscore: true,
   methods: IncomeVerificationMethod[]
   payload?: Object
}
Event Type
Description

payscore/incomeVerification/loaded

Triggers when the widget loads. Can be used to provide your own “widget loading” experience prior to widget mount.

payscore/incomeVerification/widgetClosed

Triggers when the embedded widget is manually closed by the applicant.

payscore/incomeVerification/started

Triggers when the applicant interacts with the workflow for the first time.

payscore/incomeVerification/institutionSelected

Triggers when an applicant selects a bank, payroll provider, or employer.

payscore/incomeVerification/institutionConnected

Triggers when an applicant successfully connects to their bank, payroll provider, or employer.

payscore/incomeVerification/documentUploaded

Triggers when an applicant uploads a document.

payscore/incomeVerification/completed

Triggers when the applicant completes the workflow, fills out the feedback (or skips it), and submits the report. The widget should be closed after this event.

Specific Event Payloads

Certain events contain payloads of data pertaining to the event that occurred. When using typescript, you can use the generic PayscoreBaseEvent type to narrow the payload value for your object.

Payload resolution:

payscore/incomeVerification/institutionConnected

payscore/incomeVerification/institutionSelected

Example:

Pass the event type as the generic argument and TypeScript will enforce the correct payload shape — or undefined for event types that carry no payload.

Last updated