Interested in sharing your feedback about the Google Ads API?
Sign up to be invited to participate in user research!
BillingSetupError
Stay organized with collections
Save and categorize content based on your preferences.
Enum describing possible billing setup errors.
| Enums |
UNSPECIFIED
|
Enum unspecified. |
UNKNOWN
|
The received error code is not known in this version. |
CANNOT_USE_EXISTING_AND_NEW_ACCOUNT
|
Cannot specify both an existing payments account and a new payments account when setting up billing. |
CANNOT_REMOVE_STARTED_BILLING_SETUP
|
Cannot cancel an approved billing setup whose start time has passed. |
CANNOT_CHANGE_BILLING_TO_SAME_PAYMENTS_ACCOUNT
|
Cannot perform a Change of Bill-To (CBT) to the same payments account. |
BILLING_SETUP_NOT_PERMITTED_FOR_CUSTOMER_STATUS
|
Billing setups can only be used by customers with ENABLED or DRAFT status. |
INVALID_PAYMENTS_ACCOUNT
|
Billing setups must either include a correctly formatted existing payments account id, or a non-empty new payments account name. |
BILLING_SETUP_NOT_PERMITTED_FOR_CUSTOMER_CATEGORY
|
Only billable and third-party customers can create billing setups. |
INVALID_START_TIME_TYPE
|
Billing setup creations can only use NOW for start time type. |
THIRD_PARTY_ALREADY_HAS_BILLING
|
Billing setups can only be created for a third-party customer if they do not already have a setup. |
BILLING_SETUP_IN_PROGRESS
|
Billing setups cannot be created if there is already a pending billing in progress. |
NO_SIGNUP_PERMISSION
|
Billing setups can only be created by customers who have permission to setup billings. Users can contact a representative for help setting up permissions. |
CHANGE_OF_BILL_TO_IN_PROGRESS
|
Billing setups cannot be created if there is already a future-approved billing. |
PAYMENTS_PROFILE_NOT_FOUND
|
Requested payments profile not found. |
PAYMENTS_ACCOUNT_NOT_FOUND
|
Requested payments account not found. |
PAYMENTS_PROFILE_INELIGIBLE
|
Billing setup creation failed because the payments profile is ineligible. |
PAYMENTS_ACCOUNT_INELIGIBLE
|
Billing setup creation failed because the payments account is ineligible. |
CUSTOMER_NEEDS_INTERNAL_APPROVAL
|
Billing setup creation failed because the payments profile needs internal approval. |
PAYMENTS_PROFILE_NEEDS_SERVICE_AGREEMENT_ACCEPTANCE
|
Billing setup creation failed because the user needs to accept master service agreement on the payments profile. |
PAYMENTS_ACCOUNT_INELIGIBLE_CURRENCY_CODE_MISMATCH
|
Payments account has different currency code than the current customer and hence cannot be used to setup billing. |
FUTURE_START_TIME_PROHIBITED
|
A start time in the future cannot be used because there is currently no active billing setup for this customer. |
TOO_MANY_BILLING_SETUPS_FOR_PAYMENTS_ACCOUNT
|
The payments account has maximum number of billing setups. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-12 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-12 UTC."],[[["This enum describes various errors that can occur when setting up billing for a customer."],["Errors can be related to the customer's status, the payments account, or the billing setup itself."],["Some errors indicate an issue with the requested payments profile or account, such as it being ineligible or requiring approval."],["Other errors relate to restrictions on billing setups, like starting a new one when one is already in progress or changing to the same payments account."],["Certain errors may require customer action, such as accepting a service agreement or contacting support for permissions."]]],["The content outlines various errors encountered during billing setup. Key issues include conflicts between existing and new accounts, inability to cancel started setups, and restrictions on changing to the same payment account. Setups require specific customer statuses (ENABLED or DRAFT) and categories (billable or third-party). Only immediate ('NOW') start times are allowed initially, with limitations on third-party customers with existing setups or pending billing processes. Errors also arise from invalid or ineligible payment profiles, currency mismatches and missing permissions.\n"]]
