Dissociate billing account

An existing, authenticated user selects one or more accounts to remove from their profile (i.e., one or more Account entities remove from the corresponding User entity).

Initial Request

Your client calls the Process Start API to initialize the Process:

**POST https://\{your.url\}/process/start/accountAssociation.DissociateAccount.v1.0**
<no body>

Response: Account List

Storefront Gateway responds with a prompt to specify the target Account entities, and a list of available account ids:

**RESPONSE - body**
{
   "processId": "f3ccf460-7169-4594-ae59-b18509bb1eb5",
   "processName": "accountAssociation.DissociateAccount.v1.0",
   "stepName": "AccountPrompt",
   "lastStep": booleans,
   "parameters": {
      "accounts": [
         1111,
         2222
      ]
   }
   "output": {
      "availableAccountIds": [
         6095,
         6096
      ]
   }
}

The user’s desired Account(s) must be specified by the id property on each Account entity. The client application can leverage the GET /user/accounts API, in conjunction with this Process, to retrieve additional details stored on each Account entity, in order to render meaningful selection options to the user (e.g., the Account display name, or some other relevant data on Storefront Gateway Account entity).

`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.
`accounts`	List of Storefront Gateway Account identifiers (e.g., the `id` property on each Storefront Gateway Account entity)Note: Sample values only. This is meant to illustrate the structure of the next request.
`output`	Object that contains data that the client can consume, retain, and use for additional operations.
`availableAccountIds`	List of Storefront Gateway Accounts as indicated by their unique `id` property.

Final Request: Specify Account(s)

The user selects the desired account(s), and the client passes this selection through the Process Step API request:

**PUT https://\{your.url\}/process/step**
{
   "processId": "f3ccf460-7169-4594-ae59-b18509bb1eb5",
   "parameters": {
      "accounts": [
         6096
      ]
   }
}

`processId`	Unique identifier for the current instance of this Process.
`parameters`	Object that contains the data that was requested in the previous Process response.
`accounts`	Array of one or more accounts, each specified by their `id` property

Process Complete

Storefront Gateway removes all associations between the Storefront Gateway Account (including its contained Subscriptions and Features, if any) and the User entity. It also removes any associations between the Account (et al) and the Storefront Gateway Group to which it was associated during the Associate Account Process. This also implicitly removes any associations between the Account/Subscription/Feature entities and other users who are in that Group, if any. The Process returns a 200 HTTP status:

**RESPONSE - body**
{
   "processId": "f3ccf460-7169-4594-ae59-b18509bb1eb5",
   "processName": "accountAssociation.DissociateAccount.v1.0",
   "lastStep": true
}

`processId`	Unique identifier for the current instance of this 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.
Parent topic:Dissociate Billing Account from User Process

Home

Introduction

For Merchants

For Resellers

Partner Ecosystem Management

Commerce Engine

Storefront Experience

APIs

Initial Request

Response: Account List

Final Request: Specify Account(s)

Process Complete

​Initial Request

​Response: Account List

​Final Request: Specify Account(s)

​Process Complete

Initial Request

Response: Account List

Final Request: Specify Account(s)

Process Complete