Overview
This guide walks you through connecting your Azure CSP cost data to Ripple via the Microsoft Partner Center API. The process takes approximately 5–8 minutes, though some steps require navigating multiple Azure portals.
Why Ripple Needs Partner Center Access
Ripple connects to your Microsoft Partner Center to retrieve the data needed to manage your Azure CSP billing. Specifically, Partner Center access allows Ripple to:
Import your subscription list — Subscriptions are imported into Ripple as Ripple Customers, which can then be added to Billing Groups and included in invoices
Retrieve subscription details — Information such as subscription status and type helps Ripple determine the correct calculation method for each subscription when generating invoices
Check invoice finalisation status — Partner Center provides invoice metadata that tells Ripple when an invoice has been finalised, which determines when Ripple can retrieve billed consumption data
Your data stays yours. Ripple only reads the subscription and invoice metadata necessary to calculate and generate your invoices. We do not store, share, or use your customer list for any purpose outside of your Ripple account. Access is scoped strictly to what is needed for billing.
Prerequisites
Before you begin, ensure you have the following:
An active Azure CSP account with Microsoft Partner Center access
A user with Global Admin Agent privileges — several steps in this guide require admin-level access
MFA authentication device ready — admin accounts typically have MFA enabled; have your device on hand before starting
A secure place to save credentials — you will collect the following during this process:
Partner ID (7-digit number):
App ID / Client ID:
Account ID:
Secret Key:
Directory (Tenant) ID:
Step 1: Retrieve Partner Center Credentials
Find your Partner ID
Sign in to Partner Center as a Global Admin and select the Settings (gear) icon
Go to Account settings > Legal info
(Note: Your Microsoft AI Cloud Partner Program and CSP credentials may differ)
Select Identifiers
Copy and save the 7-digit Partner ID displayed
Find your App ID / Client ID and Secret Key
Sign in to Partner Center using your Global Admin account
From the Settings menu (gear icon), select Partner settings
If Partner settings is not available, select Account settings instead
Select App management
If no app exists yet, add a new Web app. If one already exists, click Add key
After the key is generated, copy and save the following:
App ID / Client ID
Secret Key
Step 2: Register an Application in Azure Portal
You will need the following from this step:
1. Application (client) ID:
2. Directory (tenant) ID:
3. Client secret value:
Create an App Registration
Sign in to the Azure Partner Dashboard using your Global Admin account
From the left menu, click Azure Active Directory
In Azure Active Directory, click App registrations from the left menu
Click + New registration at the top of the page
Enter a name of your choice (e.g., Ripple-Azure-CSP)
Select your application user name and choose [Your Org] only – Single tenant, then set the following Redirect URL for API access:
Web-Production:
https://app.alphaus.cloud/ripple/azure-settingsWeb-Next (staging):
https://next.alphaus.cloud/ripple/azure-settings
Use the Next environment URL only if you are testing in the staging environment. For standard integration, use the Production URL.
Add API Permissions
In rare cases, searching by ID may return a different API. If this happens, search by the API name "Microsoft Partner Center" instead.
API | Permission |
Microsoft Partner Center (fa3d9a0c-3fb0-42cc-9193-47c7ecd2edbd) | Access Partner Center |
Microsoft Graph | Application permissions:
|
Microsoft Partner (4990cffe-04e8-4e8b-808a-1175604b879f) | Partner Center |
Granting API Permissions to the Application User
Click on the application user you just created
In the application management screen, click API permissions from the left menu
Click + Add a permission
In the panel that appears on the right, select APIs my organization uses
Add the following APIs:
Microsoft Partner Center (fa3d9a0c-3fb0-42cc-9193-47c7ecd2edbd)
Access Partner Center
Microsoft Graph (00000003-0000-0000-c000-000000000000)
User.Read
Microsoft Partner (4990cffe-04e8-4e8b-808a-1175604b879f)
Partner Center
After selecting all three API permissions, return to the API permissions screen and click ✔ Grant admin consent for [Your Org], then click Yes to confirm
Go to Overview in the left menu and copy and save your Application (client) ID and Directory (tenant) ID
Generating a Client Secret
This step must be performed by a user with Global Admin privileges.
From the left menu, click Certificates & secrets
Click + New client secret
Description: optional (e.g., Client secret for Ripple-Azure-CSP API integration)
Expiration: 1 year is recommended
Set the description and expiration, then click Add
Copy and save the Value of the newly created Client Secret immediately — it will not be shown again
Step 3: Configure Ripple
How to Connect Your Partner Center Credentials
Log in to Ripple using your browser's Incognito / Private mode to avoid cache-related authentication issues
Notes Using Incognito / Private mode helps prevent authentication errors caused by cached sessions.
From the left menu, go to Settings > Azure Settings
Under Onboarding Cloud Solution Provider (CSP) to Ripple, enter the Partner ID you saved in Step 1
Under Partner Center credentials, enter the Account ID, Application ID, and Secret Key from Step 1
Under Partner API credentials, enter the Application (client) ID, Directory (tenant) ID, and Client secret from Step 2
Click Next in the bottom right — you will be redirected to the Azure authentication page.
Sign in with your Global Admin account to complete authentication
After successful authentication, a secret code will be generated automatically. Review it, then click Done in Ripple to finish
Reference
Need More Help?
If any errors occur during the process or if you have any questions, please reach out to us:
📧 Email: ripple_cs@alphaus.cloud
💬 Live Chat: Available in the bottom-right corner of your dashboard
📖 Help Center: https://help.alphaus.cloud/






