For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by adding .md to their URLs.

Set up Circle paywalls in Brazil

Last updated: August, 2026

Welcome to our guide on setting up Circle paywalls in Brazil! In this article, we'll explore the essential steps for offering seamless payment experiences and effectively monetizing your content via paywalls in Brazil.

Connecting your Stripe account

Circle has direct integration with the payment processor Stripe, which allows you to securely collect payments from members via paywalls. 

To get started, you’ll need to connect with a Stripe account. Navigate to the paywalls page by clicking Payments in the left sidebar and selecting Paywalls. On the paywalls page, click New paywall to begin the process.

In the first step, you will be asked to choose the country where you plan to register your account. Be sure to choose Brazil as your country.

If you already have an existing Stripe account registered in Brazil, you can use it during the setup process. We will create a sub-account for you within your existing Stripe account. The advantage of creating a new sub-account under your existing Stripe account is that you'll have one Stripe login and can easily switch between your business dashboards without needing to log in and out.

📚 For detailed instructions on connecting a Stripe account, please refer to our guide here. 

Tax ID collection

When your community is connected with a Brazilian Stripe account, and the paywall currency is BRL, members are required to enter the relevant tax ID (CPF or CNPJ) during the paywall purchase process.

On the paywall checkout page, members can select either Brazil - CPF or Brazil - CNPJ from the dropdown menu under the Tax ID and enter their ID.

This tax ID will be added to customer information in Stripe and appear on their invoices going forward. After a member has made the purchase, you can view the tax ID details by navigating to the customer’s account details in the Customers dashboard on Stripe. In the Details section, check the Tax location status and Tax status and IDs.

Setting up the Pix payment method

When you connect your Brazilian Stripe account, you also have the option to set up the Pix payment method - an instant payment method that allows members to pay for one-time fee paywalls using a Pix string or QR code through their bank apps or internet banking. 

Here are a few key things to remember:

  • This payment method option is exclusively available for Brazilian Stripe accounts connected to Circle paywalls.

  • Pix only works for purchasing paywalls with one-time fee pricing. For subscription and installment pricing options, members must use a card payment method, such as a debit or credit card. 

  • Members can only purchase paywall using the Pix payment method if the amount is between 0.50 BRL and 15,000 BRL. If not, they will need to purchase the paywall using our supported card payment method.

Enabling Pix

Currently, Pix is part of an early-access program on Stripe. Therefore, after you have connected the Stripe account to Circle paywalls, you will need to request access to the Pix payment method by contacting the Stripe support team at support@stripe.com.

To set this up, follow these steps:

  1. Click the community name or logo in the top-left corner and select Paywalls.

  2. From the sidebar menu, navigate to the Settings page.

  3. In the payment method section, you will see instructions to contact Stripe’s support team. Follow these steps and context the support team via email.

After you send the email, you should receive confirmation in roughly 48 hours about the availability of Pix for your account.

Once the Pix payment method is enabled, you’ll have the flexibility to enable or disable it from the Settings page at any time.

Paying with Pix

When enabled, the Pix payment method appears on the paywall checkout page as a payment option for the one-time pricing paywall.

Once the member fills in all the information on the checkout page and proceeds to pay for the membership, a popup will display the Pix string and/or QR code that the member can use to complete the transaction via their Brazilian bank app or Internet banking.

The member will have one hour from the moment the Pix string and/or QR code are generated to complete the payment. If the time is exceeded, the payment will fail.

After a successful payment, the member will be redirected to a thank you page or custom redirect URL based on your paywall configuration.

💡 Tip: If a member has paid for the paywall via the Pix payment method, you will be able to see this information when viewing their transaction details on the transactions page or via their member profile.

Ready to create paywalls?

To get started with creating new paywalls and setting up various other options, we highly recommend the following articles: