Events (callback)

Events are our way of letting you know when something happens in one of our services.

ReuseID events are a type of Signicat event that are specific to the ReuseID service. For example, a ReuseID event is generated when an authentication result is ready.

Learn about Signicat events

This page focuses on ReuseID events. For general information about Signicat events and the events service, see our Events and webhooks documentation.

How do ReuseID events work?

When an asynchronous operation completes, or when ReuseID gets a notification that a device has changed state, ReuseID publishes an event with the operation result.

If you have subscribed to the event, then you automatically receive the result at your specified notification URI. This is often referred to as callback.

You can also get the operation result back through polling. The result that you receive through the Signicat events service is the same as the result obtained by polling, but wrapped in a Signicat event object.

When to use callback

We recommend that you always set up callback for production. This offers the best usability and responsiveness as it has the least amount of latency, and means that you do not need to conduct additional polling calls.

When to use polling

Regardless of whether callback is set up or not, you can fetch the result of a completed operation from Signicat by polling.

You can do this by running GET API calls, but it should only be reserved for testing and development use.

Which events does ReuseID publish?

ReuseID publishes events for the authentication methods that it supports and for operations related to managing these authentication methods.

For an overview of the events that you can subscribe to, see the tables in the sections below:

MobileID

ReuseID events related to the MobileID service, such as:

• Authentication
• Registering and managing MobileID devices
• Account recovery

Passkeys

ReuseID events related to the Passkeys service, such as:

• Authentication
• Registering a passkey
• Managing a passkey

What do ReuseID events look like?

Events follow the same structure across all Signicat services, with the exception of the event data (eventData) field. This field varies depending on the type of event, as it is where we pass the operation result as a JSON object.

You can find an overview of a ReuseID event in the table below:

How to subscribe to ReuseID events

You can use the Signicat Dashboard to subscribe to the events that you would like to receive callback for.

ReuseID uses the MobileID and Passkeys services for authentication. Both of these services publish their own events which you can subscribe to in the Signicat Dashboard, but they do not contain the full set of ReuseID information.

To get the complete ReuseID MobileID/Passkeys event information, you need to subscribe to the MobileID and Passkeys events published by the ReuseID service, not to the events published directly by the MobileID and Passkeys services.

To do this:

1. Go to Signicat Dashboard > Settings > Events.
2. Click the +Add subscription button.
3. Select a subscription type, for example Webhook.
4. Complete the required fields. In the Listen to section, under the ReuseID section, select the events that you want to subscribe to.
5. Click the Add button.

Want to learn more?

To learn more about subscribing to and managing events, see the Events and webhooks page in the Signicat Dashboard documentation.

How to preview ReuseID events

You can preview what the JSON payload looks like for each event in the Signicat Dashboard when you set up a new subscription. To do this:

1. Go to Signicat Dashboard > Settings > Events.
2. Click the +Add subscription button.
3. Select a subscription type, for example Webhook.
4. Under the Listen to section, click Selected events, then expand the ReuseID dropdown menu.
5. Hover over the event that you want to preview, then click the Preview button that appears to the right of the event name.
6. An example of the event appears to the right-hand side of the screen. You can use the Example toggle button at the top of the example to toggle between the operation result and the entire Signicat event object.

What do the properties in the example mean?

To learn what the different properties mean in the examples, see the respective response schema in the ReuseID API reference documentation.