A billing setup is an account-level link between a Google Ads account and a Payments account (also known as an invoice setup), which effectively determines who is billed for costs incurred by the billing setup's account budgets. Each Payments account corresponds to a single invoice.
About Payments accounts
BillingSetup identifies a Payments account
that gets invoiced for costs incurred by its account budgets. This Payments
account is associated with a Payments
profile that is ultimately
responsible for charges.
payments_account_info.payments_account_id: A 16-digit ID used to identify the Payments account associated with the billing setup.
payments_account_info.payments_account_name: The name of the Payments account associated with the billing setup. This name is printed on monthly invoices.
payments_account_info.payments_profile_id: A 12-digit ID used to identify the Payments profile associated with the billing setup.
If a Payments account is eligible for consolidated billing, then multiple Google Ads accounts can be grouped in the same invoice by setting their billing setups to use the same underlying Payments account.
Creating new billing setups
You can link new billing setups to existing Payments accounts or ones created at the same time.
Using an existing Payments account
You can list available payment accounts with the
PaymentsAccounts returned depend on the manager account you use for
Using a new Payments account
The example below shows how to create a new billing setup from an existing
Payments profile ID. As indicated above, this will also create a new
Payments account with the name
My New Payments Account.
BillingSetup bsetup = BillingSetup.newBuilder()
.setPaymentsAccountName("My New Payments Account")
BillingSetupOperation op = BillingSetupOperation.newBuilder().setCreate(bsetup).build();
try (BillingSetupServiceClient billingSetupServiceClient = googleAdsClient
MutateBillingSetupResponse response =
If this is the first billing setup being added to a Google Ads account, this will effectively sign the customer up for billing using the referenced Payments profile.
Billing setup status
|Billing Setup Status
|Approved but the corresponding first budget has not. This can only occur for billing setups configured for monthly invoicing.
|Setup was approved.
|Setup was cancelled by the user prior to approval.
Retrieving an account's billing setup
Canceling a pending billing setup
BillingSetup that has not yet taken effect can
be canceled using the remove operation. Billing setups can be canceled only if
or if they are
to start some time in the future.