Skip to main content

Ripple - Integrate AWS Billing Conductor with Ripple

How to configure Ripple to process billing based on AWS Billing Conductor (ABC) data.

Written by Alphaus Support Team
Updated today

Overview

This guide walks you through how to set up Ripple to process billing based on Cost and Usage Report (CUR) data configured at the Billing Group level in AWS Billing Conductor (ABC).

Steps


1. Allow API access from Ripple to the Payer account.

Ripple must be granted API access to the Payer Account in order to perform the necessary operations. This step can be skipped if API access was already granted when registering the Payer Account in Ripple.

Steps who already registered the payment account with no API access

  1. Log in to the AWS account associated with the target payer account

  2. In Ripple, go to Settings > Payer Account Settings

  3. Click on the '...' next to the target payment account and select Allow API Access

  4. Click on Cross-Account Setup

  5. In the AWS account side, click on Create Stack to execute the CloudFormation stack

  6. After the stack creation is completed, return to the Ripple interface and click on Confirm Permissions

Important Notes:

  • The user logging in to AWS must have permission to execute CloudFormation stacks

  • Please ensure you click Confirm Permissions in step 6 — failing to do so will prevent the integration from being established


Step 2: Create a Billing group on the ABC console.

  1. Log in to the AWS console for the Payer Account where you want to create the Billing Group and navigate to AWS Billing Conductor

    • You will need an account with permissions to operate Billing Conductor

  2. From the left menu, click Billing Groups, then click Create Billing Group in the top right corner

  3. Fill in the required fields and click Create Billing Group

Field

Description

Billing Group Name

Enter the name of the Billing Group

Billing Plan

Select Create a public on-demand billing plan

Accounts

Select the accounts to include in the Billing Group

Primary Account

This account acts as a pseudo-Payer Account and cannot be changed after creation. The actual Payer Account cannot be set as the Primary Account


Step 3: Create Billing group in Ripple

  1. From the left menu, click Account/Group > Billing Groups

  2. Click Add Billing Group in the top right corner, then select Import AWS Billing Conductor

  3. Select Payer account

  4. Select the Billing Group — a list of Billing Groups created in ABC for the selected Payer Account will be displayed

  5. Fill in the required details, select the accounts, and complete the Billing Group creation


Step 4: Setup Proforma CUR

  1. From the left menu, click Settings > Payer Account Settings

  2. Click ... next to the target Payer Account and select Setup Payer Proforma CUR

  3. Select the Billing Group, then enter the S3 bucket name, prefix, and region

    For the Tokyo region, enter ap-northeast-1

  4. Click Save to complete the setup ✅


Need More Help?

If any errors occur during the process or if you have any questions, please reach out to us:

Did this answer your question?