Stay organized with collections
Save and categorize content based on your preferences.
4.3.1 Direct Billing Option
UX Guidance
The ideal step in the flow to ask the user to set up billing is right after the
first campaign setup (instead of after account creation). More detail is also
provided in the Ads Campaign Creation section. This order of steps is
aligned with most check-out flows.
The billing setup cannot be performed using API, and requires you to redirect
merchants to a Google interface even if you didn't opt for the redirect option.
If you choose the redirect option for ad campaign creation and management, the
billing setup is handled in the Merchant Center. Note that when setting up
billing in Merchant Center merchants can pay by credit card.
If you choose to implement campaign creation and management in-app, the billing
setup is handled in Google Ads. The recommended way to ask users for their
billing information is by showing the billing setup in a chrome window rendered
as a dialog. As the user still sees the context of the integration in the
background, this approach feels least disruptive for them.
Manage your payment options provides an overview of the different payment
options that can be offered to merchants. A suggestion for the billing setup
steps is shown in the animation below.
The billing setup dialog also needs to show a link to the Google Ads terms and
conditions after the merchant has inputted their payment profile. This is the
best way to surface the Google Ads terms and conditions because they are
adjusted depending on the country, language and currency which can be extracted
from the payment profile.
Tech Guidance
This is how the direct billing flow would work:
Get the invitation link returned in the CreateCustomerClientResponse
and surface it to the merchant. You can set it up so that clicking on the link
opens a new browser tab (instead of replacing the current tab), so the merchant
can return to your platform.
Merchant clicks the link, which opens the Google Ads invite flow in a new
browser tab.
Merchant sets up billing in the Google Ads platform and returns to your
platform to continue the user flow.
You can confirm if the advertiser has completed the billing setup using
BillingSetupStatus.
You can also send an email by creating a new CustomerUserAccessInvitation
using the MutateCustomerUserAccessInvitation method of the
CustomerUserAccessInvitationService. See further details. No allowlist
is required. The link in the email is the same as the link returned in
CreateCustomerClientResponse and also expires after 20 days.
[[["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-09-03 UTC."],[[["\u003cp\u003eDirect billing setup is ideally done after the first campaign setup, streamlining the user experience.\u003c/p\u003e\n"],["\u003cp\u003eBilling setup necessitates redirecting merchants to a Google interface (Merchant Center or Google Ads) for payment processing.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Ads is the recommended platform for billing setup when campaign management is handled in-app, preferably using a chrome window dialog for minimal disruption.\u003c/p\u003e\n"],["\u003cp\u003eThe billing setup process involves an invitation link, Google Ads setup by the merchant, and confirmation via \u003ccode\u003eBillingSetupStatus\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers need to be allowlisted to access the invitation link for the direct billing flow, which expires after 20 days.\u003c/p\u003e\n"]]],[],null,["4.3.1 Direct Billing Option\n---------------------------\n\n### UX Guidance\n\n*** ** * ** ***\n\nThe ideal step in the flow to ask the user to set up billing is right after the\nfirst campaign setup (instead of after account creation). More detail is also\nprovided in the [*Ads Campaign Creation*](/merchant/storebuilder/online/sections/4_2_ads_campaign_creation#ux_guidance) section. This order of steps is\naligned with most check-out flows.\n\nThe billing setup cannot be performed using API, and requires you to redirect\nmerchants to a Google interface even if you didn't opt for the redirect option.\n\nIf you choose the redirect option for ad campaign creation and management, the\nbilling setup is handled in the Merchant Center. Note that when setting up\nbilling in Merchant Center merchants can pay by credit card.\n\nIf you choose to implement campaign creation and management in-app, the billing\nsetup is handled in Google Ads. The recommended way to ask users for their\nbilling information is by showing the billing setup in a chrome window rendered\nas a dialog. As the user still sees the context of the integration in the\nbackground, this approach feels least disruptive for them.\n\n[Manage your payment options](https://support.google.com/adwords/answer/7678534) provides an overview of the different payment\noptions that can be offered to merchants. A suggestion for the billing setup\nsteps is shown in the animation below.\n\nThe billing setup dialog also needs to show a link to the Google Ads terms and\nconditions after the merchant has inputted their payment profile. This is the\nbest way to surface the Google Ads terms and conditions because they are\nadjusted depending on the country, language and currency which can be extracted\nfrom the payment profile.\n\n### Tech Guidance\n\n*** ** * ** ***\n\nThis is how the direct billing flow would work:\n\n1. Get the invitation link returned in the [`CreateCustomerClientResponse`](https://developers.google.com/google-ads/api/reference/rpc/v12/CreateCustomerClientResponse)\n and surface it to the merchant. You can set it up so that clicking on the link\n opens a new browser tab (instead of replacing the current tab), so the merchant\n can return to your platform.\n\n | **Note:** An allowlist is required to get this invitation link. Note that the link expires after 20 days. Contact your Google partner team to request to be added to the *allowlist*.\n2. Merchant clicks the link, which opens the Google Ads invite flow in a new\n browser tab.\n\n3. Merchant sets up billing in the Google Ads platform and returns to your\n platform to continue the user flow.\n\n4. You can confirm if the advertiser has completed the billing setup using\n [`BillingSetupStatus`](https://developers.google.com/google-ads/api/reference/rpc/v12/BillingSetupStatusEnum.BillingSetupStatus).\n\n5. You can also send an email by creating a new `CustomerUserAccessInvitation`\n using the `MutateCustomerUserAccessInvitation` method of the\n `CustomerUserAccessInvitationService`. See [further details](https://developers.google.com/google-ads/api/docs/account-management/managing-invitations). No allowlist\n is required. The link in the email is the same as the link returned in\n `CreateCustomerClientResponse` and also expires after 20 days."]]
