Skip to main content
Bouclay runs the billing side of your product: plans, subscriptions, usage, invoices, credits, failed-payment recovery and webhooks. You connect your own payment gateway account, call the Bouclay API from your server, and listen for Bouclay webhooks. Bouclay does the rest. Bouclay never holds your money. Every charge, refund and payout happens on your own gateway account, with your own keys. Bouclay tells the gateway what to charge and when, and keeps the records.

​
Who does what

​
What you can build

Subscriptions with trials

Monthly or yearly plans, free trials, seats, pauses, and cancellations at the end of the period.

Usage billing

Send usage events and bill per API call, per message or per token, with tiers and included units.

Paywalls from entitlements

Ask “can this customer use this feature?” and get a yes or no, kept in step with billing.

Prepaid credit

Sell top-ups, give promotional credit, and stop a customer exactly when their credit runs out.

Invoices for businesses

Pay by bank transfer, payment terms, purchase order numbers and VAT on every invoice.

Payment links

Share a checkout page on WhatsApp or as a QR code, with no code at all.

​
Start here

1

Connect a gateway in test mode

In the dashboard, open Developers → Payment gateways and connect your gateway with its test keys. See Connect a gateway.
2

Create an API key

Open Developers → API Keys and create a secret key. Test keys start with sk_test_.
3

Follow the quickstart

The quickstart takes you from a new customer to a paid subscription and a working paywall.
Every page in the API reference has a playground. Paste a test key and send real requests from the browser.