Checkout
Configure the RevenueCat Billing checkout experience, including billing address collection and terms consent
RevenueCat Billing uses its own checkout that your customers see when completing a purchase. Most of the checkout experience is shaped by settings elsewhere in your config:
- Payment methods change depending on browser, location, and configuration (see Apple Pay & Google Pay).
- Tax collection is configured in your RevenueCat Billing config and your tax provider's dashboard (see Sales Tax & VAT).
- Colors, shapes, and other styling are configured in the appearance editor (see Custom Branding).
This page covers the checkout options you configure in the Billing tab of your RevenueCat Billing config: when to collect a customer's full billing address, and whether customers must agree to your terms before paying.
Address collection
Address collection controls when customers are asked for their full billing address during checkout. It doesn't affect express checkout or wallet payment methods such as Apple Pay and Google Pay, which supply their own address details.
You can choose between two options:
- Only when required (default): Customers are asked for their full billing address only when it's needed, such as for tax calculation.
- Always: Customers are always asked for their full billing address at checkout.
To configure address collection:
- Navigate to the RevenueCat Billing config in your RevenueCat account.
- In the Billing tab, find the Address collection section.
- Select Only when required or Always.
- Save the changes.
When you collect tax, a customer's tax location is determined from the billing address they enter at checkout. With Only when required, customers are still asked for the address details needed to calculate tax. See Sales Tax & VAT for more detail.
Terms consent
Terms consent adds a required checkbox to the checkout to enforce agreement to your terms before paying. When enabled, customers must select the checkbox before they can complete their purchase.
For the checkbox to appear, a Terms URL must be configured in the checkout or Web Purchase Link settings.
To set your terms URL:
- For Web Purchase Links: Configure the terms URL when you create or edit a purchase link.
- For Web SDK integrations: Pass your terms URL as
termsAndConditionsUrlto the PurchaseParams when configuring the purchase. - For Web Funnels: Terms acceptance is not currently supported.
To require terms consent in the checkout:
- Navigate to Web, and select your RevenueCat Billing config in the RevenueCat dashboard.
- In the Billing tab, find the Terms consent section.
- Enable Require customers to agree to terms before paying.
- Save the changes.