New user accepts invitation

Storefront Gateway User Jane invites her roommate John to share access to one of her services. The client application for the service uses the Share Access to an Account/Subscription/Feature Process. At the end of that Process, Storefront Gateway sends an invitation to John’s email or mobile number (whichever Jane provided to the previous Process). John then uses that link to redirect to the application, and explicitly accept her invitation. In this use case, John is not yet a registered Storefront Gateway User, so this Process also handles the onboarding parts of John’s journey.

Initial Request

The invitee user clicks the invitation link, which then redirects them back to a dedicated landing page in your application. Your client takes the action token value directly from the redirect URL, and calls the Session Token API with the token value as a URL parameter. This initializes the Process:

**GET https://\{your.url\}/session/token?value=681e508b-aa16-48db-a9f7-3d58d464e7c3**
<no body>

Response: Accept or Decline

Storefront Gateway responds with a prompt for the user to explicitly accept or decline the invitation:

**RESPONSE - body**
{
   "processId": "de4f55a4-e9df-4142-98b4-5de739c82188",
   "processName": "entitlementManagement.UserAcceptDeclineInvite.v1.0",
   "stepName": "AcceptPrompt",
   "displayMessage": "Please input required information",
   "parameters": {
      "accept": "Boolean"
   }
}

`processId`	Unique identifier for the current instance of this Process.
`processName`	Full name of the Process, including the category and version number.
`stepName`	Name of the specific step that the Process is currently on.
`displayMessage`	Optional message that the UI can display to the user.
`parameters`	Object that specifies the info this Process requires to continue its task.
`accept`	Boolean that indicates if the user accepts the service invitation.

Next Request: User Accepts

The user explicitly accepts, and your client passes this choice back to the Process through the Process Step API:

**PUT https://\{your.url\}/process/step**
{
   "processId": "c18d8e7b-6817-4a0c-9ca8-76036b82b0fc",
   "parameters": {
      "accept": **true
**   }
}

`processId`	Unique identifier for the current instance of this Process.
`parameters`	Object that contains the data requested in the previous Process response.
`accept`	Boolean that indicates if the user accepts the service invitation.

Response: Complete Onboarding

The invitee does not yet have a fully activated Storefront Gateway User ID. Therefore, the Process returns a prompt for a password (and any additional, optional information) to complete the user’s onboarding:

**RESPONSE - body**
{
   "processId": "de4f55a4-e9df-4142-98b4-5de739c82188",
   "processName": "entitlementManagement.UserAcceptDeclineInvite.v1.0",
   "stepName": "UserDetailsPrompt",
   "displayMessage": "Please input required information",
   "parameters": {
      "firstName": "String",
      "lastName": "String",
      "password": "String",
      "displayName": "String",
      "lang": "String"
   }
}

`processId`	Unique identifier for the current instance of this Process.
`processName`	Full name of the Process, including the category and version number.
`stepName`	Name of the specific step that the Process is currently on.
`lastStep`	Boolean that indicates whether or not this was the last step in the Process.
`displayMessage`	Optional message that the UI can display to the user.
`parameters`	Object that specifies the info this Process requires to continue its task.
`password`	(Mandatory) User’s desired password.
`firstName`	(Optional) User’s first name.
`lastName`	(Optional) User’s last name.
`displayName`	(Optional) A display name for the user. This could be just a combination of the user’s first and last name, or a nickname.
`lang`	(Optional) User’s preferred language, as per ISO 639-1:2002.

Final Request

The user provides a password, and your client and the client passes this through the Process Step API request:

**PUT https://\{your.url\}/process/step**
{
   "processId": "de4f55a4-e9df-4142-98b4-5de739c82188",
   "parameters": {
      "password": "**L3tm3inpl4ase**",
   }
}

`processId`	Unique identifier for the current instance of this Process.
`parameters`	Object that contains the data requested in the previous Process response.
`password`	User’s desired password.
`firstName`	User’s first name.
`lastName`	User’s last name.
`displayName`	A display name for the user. This could be just a combination of the user’s first and last name, or a nickname.
`lang`	User’s preferred language, as per ISO 639-1:2002.

Process Complete

If the user’s password is valid, then Storefront Gateway activates the following:

The new Storefront Gateway User entity
The new user’s AuthN ID
The associations between the new User entity and the shared accounts / services (that were selected by the inviting user during the Share A/S/F Process)
The association between the new User entity and the relevant Storefront Gateway Group (to which the shared A/S/F is associated)

The Process then automatically authenticates the user, and returns a 200 HTTP status:

**RESPONSE - body**
{
   "processId": "de4f55a4-e9df-4142-98b4-5de739c82188",
   "processName": "entitlementManagement.UserAcceptDeclineInvite.v1.0",
   "lastStep": **true**,
   "runtimeId": 5010,
   "userId": **6014**,
   "userAuthenticated": **true**
}

The user now has access to their own User ID, and any of the accounts/services that were shared with them.

`processId`	The unique identifier for this instance of the Process.
`processName`	Full name of the Process, including the category and version number.
`lastStep`	Boolean that indicates whether or not this was the last step in the Process.
`runtimeId`	Identifier of the Storefront Gateway Runtime entity currently associated to the Storefront Gateway User entity. About Runtime Entities:Upon user creation or authentication, Storefront Gateway looks for a JRUNTIMEID cookie in the end user’s browser or application. If no cookie is found, Storefront Gateway creates a Runtime Entity with a unique ID and associates it to the user during the login phase. Storefront Gateway will generate and pass a corresponding JRUNTIMEID cookie for clients to store and return with subsequent requests.
`userId`	The unique identifier of the current user.
`userAuthenticated`	Boolean that indicates if the user was authenticated into Storefront Gateway.
Parent topic:Accept or Decline Service Invitation Process

Home

Introduction

For Merchants

For Resellers

Partner Ecosystem Management

Commerce Engine

Storefront Experience

APIs

Initial Request

Response: Accept or Decline

Next Request: User Accepts

Response: Complete Onboarding

Final Request

Process Complete

​Initial Request

​Response: Accept or Decline

​Next Request: User Accepts

​Response: Complete Onboarding

​Final Request

​Process Complete

Initial Request

Response: Accept or Decline

Next Request: User Accepts

Response: Complete Onboarding

Final Request

Process Complete