Notifications

Info

Applications integrated with linkID can subscribe to following linkID topics:

• urn:net:lin-k:linkid:topic:user:remove
  • a user which has a subscription to your application was removed
• urn:net:lin-k:linkid:topic:user:unsubscribe
  • a user which has a subscription to your application removed his subscription
• urn:net:lin-k:linkid:topic:user:attribute:update
  • a specific attribute you want to be notification about has been updated by a linkID user
• urn:net:lin-k:linkid:topic:user:attribute:remove
  • a specific attribute you want to be notification about has been removed by a linkID user
• urn:net:lin-k:linkid:topic:user:identity:update
  • an attribute in one of the identity profiles attached to your application has been modified or removed for a linkID user
• urn:net:lin-k:linkid:topic:expired:authentication
  • a linkID authentication session has expired
• urn:net:lin-k:linkid:topic:expired:payment
  • a linkID payment session has expired
• urn:net:lin-k:linkid:topic:mandate:archived
  • a linkID user's payment mandate has been archived
• urn:net:lin-k:linkid:topic:ltqr:session:new
  • a new client session was started for a LTQR of your application
• urn:net:lin-k:linkid:topic:ltqr:session:cancel
  • a client session for a LTQR of your application was canceled by a linkID user
• urn:net:lin-k:linkid:topic:ltqr:session:update
  • a client session for a LTQR of your application has finished for a linkID user
• urn:net:lin-k:linkid:topic:config:update
  • internal configuration in linkID was updated, i.e. if new themes were added, identity profiles, ...
• urn:net:lin-k:linkid:topic:payment:update
  • an update for a payment order is available
• urn:net:lin-k:linkid:topic:authentication:retrieved
  • linkID authentication session was retrieved by a linkID mobile client (== user scanned the QR code)
• urn:net:lin-k:linkid:topic:authentication:success
  • linkID authentication session was finalized by a linkID mobile client
• urn:net:lin-k:linkid:topic:authentication:payment:finished
  • linkID payment session was finalized by a linkID mobile client
• urn:net:lin-k:linkid:topic:authentication:canceled
  • linkID session was canceled by a linkID mobile client
• urn:net:lin-k:linkid:topic:authentication:failed
  • linkID session has failed

If you wish to receive notifications for one of those events, contact a linkID operator to enable this. You can ask to configure multiple notification endpoints for your application if you want this.

The notification will be a simple HTTP GET to a location you agree on with a linkID administrator and will look like this:

https://{your-notification-location}?topic=urn%3Anet%3Alin-k%3Alinkid%3Atopic%3Auser%3Aattribute%3Aupdate&...

The query parameters depend on the type of topic.

Query parameters

The SDK provide a LinkIDNotificationConstants class for all query parameter constants and a LinkIDNotificationMessage convenience class that'll parse the query parameters in the notification poke

Response

linkID expects a HTTP Status code 200 or 202 for these pokes, if not linkID will retry a couple of times with some delay in between.