Design billing integration

Design billing integration
Compare pricing models, checkout options, and payment timing to make informed decisions before you start building your integration

There are several ways to build your Billing 2.0 integration. When planning your setup, consider the following:

  • Price models: Choose the billing logic that fits your business.
  • Checkout options: Choose how customers provide their payment information.
  • Billing timing: Choose whether to charge immediately or offer a trial.

Price models

Solidgate Billing 2.0 supports the following pricing models. Choose the one that matches how you charge customers.

One-time purchases
Charge customers a single time for a product, service, or lifetime license.
Flat rate
Charge customers a fixed recurring amount on a regular billing cycle.
Per-seat
Charge customers based on the number of users, licenses, or accounts they need.

One-time purchases

Use an invoice for a single, non-recurring charge instead of a subscription. An invoice acts as the billing record. It connects a customer to a charge and contains a line item with quantity, price, tax, and any applied discounts.

Example

You sell a lifetime software license or a physical item for a fixed price.

Flat rate

Bill a fixed price on a recurring schedule. A subscription has one recurring line item referencing that price. To bill a single flat amount per cycle, set quantity to 1 and keep it fixed for the life of the subscription.

Example

You offer a standard monthly subscription to your streaming service for 10 USD.

Per-seat

Bill for multiple units of the same price by setting quantity on the line item. Pass quantity when you create the subscription. You can adjust it at any time by updating the subscription with a new quantity value.

Choose when a quantity change takes effect, immediately or at the end of the billing period, by specifying it in the mode field.

Example

You offer B2B software where each employee account (seat) costs 15 USD per month.

Checkout options

Compare the following checkout options and determine how you want your customers to provide their payment information.

OptionDescription
Payment FormUse a secure, Solidgate-hosted payment page. It handles the payment method collection, validation, and supports local payment methods out of the box.
Payment PageRedirect customers to a Solidgate-hosted payment page to complete the purchase. It offers built-in security, mobile optimization, and customizable branding.
Payment LinkCreate a link that you can share directly with customers via email, SMS, or chat. When clicked, it redirects customers to a hosted payment page.
Solidgate APIBuild your own checkout UI and use the Solidgate API to process payments. This gives you complete control over the look and feel of the checkout flow.

Billing timing

Determine when you want to bill your customers for the subscription to your product or service.

Billing timingDescription
Upfront paymentRequire customers to pay before you provide access to your service. After the initial charge, bill the customer at regular recurring intervals.
Paid trialOffer customers a trial period at a reduced price. After the trial ends, bill the customer the full recurring amount.
Free trialOffer customers a free trial period before billing them. Collect payment information upfront, but delay the first charge until the trial ends.

Next steps

Once you map out your pricing model, checkout options, and payment timing, start building.

Invoicing overview

Learn the end-to-end flow for billing one-time purchases and generating invoices.

Subscription overview

Learn how subscription lifecycle statuses, billing periods, trials, and line items work.


Looking for help? Contact us
Stay informed with Changelog