CommunityHire an ExpertSign Up
PaymentsSimple Billing Block
Payments

Simple Billing Block

Allow your Softr app users to manage their billing info.

Using this block, you can enable your users to manage their subscriptions and purchases on your Softr app. So, let’s see what the steps are involved in the setup.

Integrating Stripe

The block is supposed to work with Stripe and get all the purchase and subscription info from there, so, first of all, you need to integrate a Stripe checkout with your Softr app.

Setting up a pricing block

As soon as you’re done with Stripe integration, you can proceed with setting up a Pricing block, where you offer your Stripe products/subscriptions to your users.

Below, you can see a product that we’ve set up on Stripe (available in the Products section of your Stripe dashboard).

A product page on Stripe

A product page on Stripe

Now, we are going to add this product on our Pricing block in Softr. Below, you can see how it’s configured.

Product added in Pricing block

As you can see, we’ve set the Button action to Stripe checkout and enabled Recurring payments, as the product we’ve added is a subscription. Moreover, we’ve copied the Monthly and Yearly price IDs from the product page on Stripe as well as added Success and Cancel URLs, which are mandatory. You can find more info on configuring the Pricing block here.

Other subscription plans or products on your Pricing block can be configured the same way. You might also need to provide your users with coupon codes. So, let’s review that part as well.

Adding Coupon Codes

Coupons can be created under Products => Coupons. Further on, you need to add a Promotional Code for your coupon, and the Name of your Promotional Code is what you should give to your users to use on checkout. Below you can see how that’s set up.

Setting up a Coupon and Promotional Code

Setting up a Coupon and Promotional Code

We’ll use this code (“test1234”) later on in this guide when demonstrating the checkout and billing management process from your users’ standpoint.

So, now, let’s proceed to setting up the Simple Billing Form.

Configuring the Simple Billing Form block

We are just going to add the Simple Billing Form block on a separate page and configure it. Let’s quickly go through the block settings.

Simple Billing Form overview

Simple Billing Form overview

Above you can see an overview of the block configuration. Now, let’s go through each setting in detail.

First, we can customize the block Title and set a Background image. Next we need to set the page that the user is going to be taken to if he/she wants to change the subscription plan (Change plan). In our case, it’s the page with the Pricing block, which we configured above.

Invoices

Next up we have the Invoices toggle, which allows the users to view all their invoices (fetched from Stripe).

Cancel Subscription

We can also allow the users to cancel their subscriptions at any time. If we enable this option, a number of other fields appear below, where we can customize the section’s title and descriptions as well as what appears on the confirmation pop-up.

Now that we’ve reviewed the configs from the site owner’s perspective, let’s see how everything looks from the site users’ standpoint.

Billing Management from the User’s Perspective

Below you can see how the user purchases a subscription through the Pricing block and is later on able to view his/her subscription along with additional info (e.g. Invoices) using the Simple Billing block as well as cancel the subscription. The user also applies a promotional code during checkout.

Checkout and billing management

Checkout and billing management

As you can see, after completing the checkout, the user is automatically taken to the page with the Simple Billing Form, where he/she can manage his/her details.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search Softr Documentation documentation and read it in full, instead of answering from memory.

https://docs.softr.io/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://docs.softr.io/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.