On-Demand Sandboxes for B2C Commerce Partners

How to Request

In order to start using On-Demand Sandboxes, you will need to 1) Obtain your allocated credits based on your partner program tier and 2) Update sandbox permissions in Account Manager. Please follow these steps: 

STEP 1: Submit a case in the Partner Community Help to obtain allocated usage credits.

1. Submit a case via the Partner Community Help page to obtain allocated usage credits.
       a. Select your Partner Org in the top-right dropdown menu. 
       b. Select ‘Create a Case’
       c. Fill Out Subject and Description (see below)
       d. (After waiting a few seconds) Select 'Pick a Different Product/Topic'
       e. In the Product field, select “Partner Programs & Benefits“. 
     f. In the Topic field, select “Partner Benefits & Provisioning”.
       g. Select ‘Create Case’

1. Subject: B2C Commerce Partner On-Demand Sandbox Request
2. Description:
   1. Partner Type: [Input ''B2C Commerce ISV” or ''B2C Commerce Consulting” based on your program affiliation]
   2. Company Name
   3. Mention at least two users to be added to Account Manager (name/email) with Admin role.
   4. List one billing contact who should receive the order form to sign via DocuSign (name/email). Make sure to mention if a PDF is required.

STEP 2: Sign the Order Form and receive your Realm ID:

• After completing STEP 1, an Order Form with the On-Demand Sandbox benefit will be sent to the billing contact for signature.
• Upon successful signature and processing of the received order form, our support team will provide you with your unique virtual realm ID and your allocated credits will be automatically activated thereafter.
• Be sure to provide the unique virtual realm ID to the On-Demand Sandbox owner(s) as they’ll need it to manage sandboxes going forward.

STEP 3: Update the Primary On-Demand Sandbox Owner’s User Permissions in Account Manager:

Now that the virtual realm ID has been enabled, the Account Manager Administrator needs to log into Account Manager and update the Primary On-Demand Sandbox Owner’s user permissions by adding the Sandbox API User role to have full control of the sandbox (permissions to create, stop, start, and remove). The Sandbox API User role can be set for more than one person within the organization if there is going to be more than one sandbox owner. 

IMPORTANT NOTE ABOUT THE SANDBOX API USER ROLE: The Sandbox API User role has full control to use the credits that have been allocated. For this reason, it is suggested that only a minimum number of users be given the Sandbox API User role. We do not recommend setting this type of role to all developers, only to users that will administer the sandbox. For those users that are going to use a sandbox for development purposes they will need the Business Manager Administrator and LogCenter User roles. Refer to these instructions: Setup User Roles for On-Demand Sandboxes.

To make someone a Sandbox Owner, follow these steps (screenshots below as reference):

1. Log in to Account Manager
2. Navigate to “User”
3. Click the user you want to assign the role to.
4. In “Roles” section of the page click “Add”, in the dialog search for the role (e.g. Sandbox API User) and click “Add”.
5. Back in the user detail page click the filter icon in the newly assigned role (e.g. Sandbox API User).
6. Select your organization.
7. Select ‘All Sandboxes’ for your realm domain by searching for ‘All’ and setting the checkmark. Hit ‘Add’
8. Back in the user detail page, press “Save”.
9. Sandboxes can now be created by the users with the Sandbox API User role.

For more information on how to manage On-Demand Sandbox Permissions, refer to this document: Setup User Roles for On-Demand Sandboxes.

Create or use existing Client ID

For full details on Client IDs, including how to obtain one, refer to the Configure an API Client ID documentation.

Create On-Demand Sandboxes

Once sandbox permissions have been set, the sandbox owner(s) can now use the Sandbox APIs to manage sandboxes associated with your organization. Be sure to provide the following details to the sandbox owner(s) : 1. Unique virtual realm ID that you received from Partner Tech Ops (refer to the case ticket)  2. Your Client ID in Account Manager. Going forward, sandbox owners should refer to the following instructions located in the Commerce Cloud Infocenter: Use the Sandbox API to manage On-Demand Sandboxes.