Activation Parameters for Provisioning with a Microsoft Domain

The following is an example of the activation parameters to create a new subscription providing a new Microsoft Domain. In this example for the distribution model, the Partner of Record attestation is sent in the request and the subscription will be created for a new tenant. As you can see, the agreement information is included in the example. You can use this example to build your own request by providing the required values for each property or deleting the properties that you do not need according to the information provided in this guide.

Note:
- Refer to CloudBlue Commerce API documentation for additional information on how to manage orders through the platform's API.
- The connector only supports .onmicrosoft.com domains.

Copy

{
    "activationParameters": [
        {
            "key": " microsoft_order_type",
            "value": "new_customer"
        },
        {
            "key": "microsoft_domain",
            "value": "initial_domain.onmicrosoft.com"
        },
        {
            "key": "agreement_first_name",
            "value": "First Name"
        },
        {
            "key": "agreement_last_name",
            "value": "Last Name"
        },
        {
            "key": "agreement_email_address",
            "value": "sample@email.com"
        },
        {
            "key": "agreement_phone_number",
            "value": "12763333030"
        },
        {
            "key": "mca_attestation_accepted",
            "value": "YES"
        },
        {
            "key": "special_qualifications",
            "value": "None"
        },
        {
            "key": "partner_on_record_attestation_accepted",
            "structured_value": {
                "YES": true
            }
        }
    ]
}

Additionally, in cases when the customer details or the company information did not pass Microsoft's validation, the following parameters must be used:

Copy

{
    "activationParameters": [
        {
            "key": " microsoft_order_type",
            "value": "new_customer"
        },
        {
            "key": "microsoft_domain",
            "value": "initial_domain.onmicrosoft.com"
        },
        {
            "key": "customer_organization_registration_number",
            "value": ""
        },
        {
            "key": "customer_first_name",
            "value": "First Name"
        },
        {
            "key": "customer_middle_name",
            "value": "Middle Name"
        },
        {
            "key": "customer_last_name",
            "value": "Last Name"
        },
        {
            "key": "customer_email",
            "value": "sample@email.com"
        },
        {
            "key": "customer_company_name",
            "value": "Customer Company Name"
        },
        {
            "key": "customer_phone_number",
            "value": "12763333030"
        },
        {
            "key": "customer_country",
            "value": "US"
        },
        {
            "key": "customer_state",
            "value": "VA"
        },
        {
            "key": "customer_address",
            "value": "14000 Verona Ln"
        },
        {
            "key": "customer_postal_code",
            "value": "20120-6342"
        },
        {
            "key": "agreement_first_name",
            "value": "First Name"
        },
        {
            "key": "agreement_last_name",
            "value": "Last Name"
        },
        {
            "key": "agreement_email_address",
            "value": "sample@email.com"
        },
        {
            "key": "agreement_phone_number",
            "value": "12763333030"
        },
        {
            "key": "mca_attestation_accepted",
            "value": "YES"
        },
        {
            "key": "special_qualifications",
            "value": "None"
        },
        {
            "key": "partner_on_record_attestation_accepted",
            "structured_value": {
                "YES": true
            }
        }
    ]
}

The example below includes the parameters that must be used for an additional purchase when the customer already exists, contains an Azure Plan and Customer Agreement is already accepted:

Copy

{
    "activationParameters": [
        {
            "key": " microsoft_order_type",
            "value": "new_subscription"
        },
        {
            "key": "microsoft_domain",
            "value": "initial_domain.onmicrosoft.com"
        },
        {
            "key": "special_qualifications",
            "value": "None"
        }
    ]
}

The following example includes the parameters that must be used for an additional purchase when the customer already exists, contains an Azure Plan, and the Customer Agreement acceptance is pending.

Copy

{
    "activationParameters": [
        {
            "key": " microsoft_order_type",
            "value": "new_subscription"
        },
        {
            "key": "microsoft_domain",
            "value": "initial_domain.onmicrosoft.com"
        },
        {
            "key": "agreement_first_name",
            "value": "First Name"
        },
        {
            "key": "agreement_last_name",
            "value": "Last Name"
        },
        {
            "key": "agreement_email_address",
            "value": "sample@email.com"
        },
        {
            "key": "agreement_phone_number",
            "value": "12763333030"
        },
        {
            "key": "mca_attestation_accepted",
            "value": "YES"
        },
        {
            "key": "special_qualifications",
            "value": "None"
        }
    ]
}

In the following example you can see the parameters for an additional purchase when the customer already exists, contains a legacy Global Plan with only one subscription, and the Customer Agreement is already accepted [Transition is required].

Copy

{
    "activationParameters": [
        {
            "key": " microsoft_order_type",
            "value": "new_subscription"
        },
        {
            "key": "microsoft_domain",
            "value": "initial_domain.onmicrosoft.com"
        },
        {
            "key": "special_qualifications",
            "value": "None"
        },
        {
            "key": "transition_azure_plan_confirmation",
            "value": "YES"
        }
    ]
}

Finally, you can see an example of a subscription import when the Customer Agreement is already accepted:

Copy

{
    "activationParameters": [
        {
            "key": " microsoft_order_type",
            "value": "import_subscription"
        },
        {
            "key": "microsoft_domain",
            "value": "initial_domain.onmicrosoft.com"
        },
        {
            "key": "import_microsoft_subscription_id",
            "value": "6a02fc17-68b2-4ca7-8891-350ccd89539c"
        }
    ]
}

There are some cases where additional info will be requested to the customer through an inquiring request. For example, the first time a customer interacts with a domain that has not been created initially with a “new_customer” “microsoft_order_type”, to validate the domain ownership.