Set up invoicing¶
Who can do this
View Invoices to see these settings. Create Invoices to change layout sets and Invoicing Settings; Edit Invoices to change Standard Line Items and Tracking Categories. Without the right, the page says it's read-only and which right you need. Connecting Stripe or Paystack is an app connection, so it needs Create and change automations.
The settings for quotes and invoices are under Settings → Accounting.
How documents look¶
Settings → Quote/Invoice Layout holds your layout sets. A layout set is a design for the PDF, plus the online payment settings that go with it. Most accounts need one; add more for different brands or kinds of work. Each quote and invoice is printed with the layout set chosen on it.

- Add makes a new layout set from the standard design.
- Layout Name is how the set appears in the Layout list on a document.
- Template is the design itself. Click a variable on the right to put it at your cursor, or drag it to where you want it — Line Items, Total, Invoice Number, Pay Now Button, the client's name and number, any of your client custom fields, and your company name. Changes save as you type. A client custom field above the Custom Field View Level of whoever makes the PDF prints blank; a PDF made by a workflow or a recurring invoice shows every field.
- Preview PDF shows the design filled in with sample values.
Pay-now links of your own¶
Total, Sub Total and VAT / Tax print with your currency symbol and spaces between the thousands
(R1 380.58). A payment link needs the plain number, so use the (number only) versions in links:
{{total_raw}}, {{subtotal_raw}} and {{total_vat_raw}} print 1380.58. For example, a PayFast link:
<a href="https://www.payfast.co.za/eng/process?cmd=_paynow&receiver=12345678&item_name=Invoice+{{quote_invoice_o_id_full}}&amount={{total_raw}}">Pay now</a>
A connected AI app can read, change, preview and add layout sets for you, and fix the page break below. See What you can ask.
When the line items jump to page 2¶
If a long quote leaves page 1 empty under the header and starts its lines on page 2, the layout is holding the line
items together. That happens when Line Items sits inside a table in your template, which the standard design
does. In the HTML, add style="break-inside: auto; page-break-inside: auto;" to each <table> and <tr> that
holds {{line_items}}. The lines then break between items, and the column headings repeat on the next page.
Online payments¶
Let clients pay invoices by card through Stripe or Paystack.
- Connect your Stripe or Paystack account under Settings → App Connections & Keys, and authorise it.
- In Settings → Quote/Invoice Layout, open the layout set and its Payment Gateway tab, and choose the connection.
- Copy the Payment Webhook URL shown there and add it to your provider, as below. Without it, the client's payment goes through but the invoice is never marked paid.
- Click Test payment setup. BaseCloud asks your provider whether everything works, and says what to fix if anything doesn't. Nothing is charged.
Test your payment setup¶
Test payment setup, under Webhook Secret, checks with Stripe or Paystack:
- Secret key: that it works, that it isn't a test key, and for Stripe that payments are switched on for the account. A key rolled in Stripe shows here as turned down.
- Payment Webhook URL: for Stripe, that this exact address is in your Stripe account, switched on and sending
checkout.session.completed, and whether an old BaseCloud address is still there. Paystack doesn't let anyone read its webhook address, so check that one by hand. - Webhook Secret: that one is saved and looks like a Stripe signing secret (
whsec_…). Stripe never hands a signing secret back, so the first payment is what proves it matches: the destination's Event deliveries in Stripe should show a green 200.
Secret key sits under the gateway you chose. It belongs to the app connection,
so every layout set using that connection gets a new key you paste here. If you roll your key in Stripe, paste the new
one here straight away: until you do, clients can't start a payment, cards can't be saved, and saved cards can't be
charged. Changing it needs Create and change automations. A publishable key (pk_…) or a webhook secret
(whsec_…) pasted here by mistake isn't saved, so it can't replace the key that works.
Add the payment webhook to Stripe or Paystack¶
When a client pays an invoice online, your payment provider tells BaseCloud by calling the Payment Webhook URL. That is how the invoice gets marked paid. Without it the money still reaches you, but the invoice stays unpaid in BaseCloud. You set this up once.
Stripe¶
- In BaseCloud, click the Payment Webhook URL to copy it.
- Sign in at dashboard.stripe.com. Check you are not in test mode or a sandbox: there should be no orange Test mode or Sandbox banner at the top.
- Search for Webhooks at the top of Stripe and open it (it is under Developers), then click Add destination.
- Stripe asks which events to send. Leave Your account selected. In the event search box, type
checkout.session.completed, tick it, and click Continue. This is the event for "a client finished paying", and it is the only one BaseCloud needs. - Choose Webhook endpoint as the destination type and click Continue.
- Paste the address into Endpoint URL and click Create destination.
- On the page that opens, find Signing secret, click Reveal, and copy it. It starts with
whsec_. - Back in BaseCloud, paste it into Webhook Secret. It saves by itself.
Already have a Stripe destination? Open it, click Edit destination, and check the URL matches exactly and that
checkout.session.completed is ticked. The Webhook Secret in BaseCloud must be that destination's signing secret.
To test it, pay a small invoice. In Stripe, the destination's Event deliveries tab should show it with a green 200.
Paystack¶
- In BaseCloud, click the Payment Webhook URL to copy it.
- Sign in at dashboard.paystack.com and click Settings at the bottom left.
- Open the API Keys & Webhooks tab.
- Paste the address into Live Webhook URL, not the Test one.
- Scroll down and click Save changes.
That's all. Paystack sends every payment to this address by itself, so there are no events to choose. You don't need a Webhook Secret either: Paystack signs its messages with the secret key you used when you connected it.
Paystack has one webhook address per account. If another system already uses it, replacing it stops that system getting payments.
Each layout set has its own address. If you delete a layout set and make a new one, the address changes, and you need to paste the new one into your provider.
Payments go through but invoices stay unpaid
Open the webhook in your provider and look at its recent deliveries. Invalid or missing token means the address is out of date: copy it again from BaseCloud. Invalid stripe signature means the Webhook Secret in BaseCloud isn't this destination's signing secret: copy it again from Stripe. Then resend the failed events from your provider.
When the card isn't saved
A Stripe payment also saves the client's card, so later invoices can be charged to it, and calls your Billing Webhook URL. If the payment goes through but the card can't be saved, a note on the client says so and gives Stripe's reason. Resending the event from Stripe tries again without paying the invoice twice. If it still can't be saved, ask the client to add their card again.

| Setting | What it does |
|---|---|
| Secret key | The chosen connection's Stripe or Paystack secret key. Paste a new one here when you roll it. See above. |
| Payment Webhook URL | The address to add to Stripe or Paystack, with the steps for the provider you chose. See above. |
| Webhook Secret | Stripe's signing secret for the webhook, so BaseCloud can trust its payment messages. Paystack doesn't need one. Once saved it isn't shown again — the box reads A secret is saved — enter a new one to replace it. |
| Requires consent before payment | The client must agree to your Consent Text before paying. |
| SLA / Terms Link | A link to your terms, shown on the payment page. |
| Test payment setup | Checks the key, the webhook and the secret with your provider, and says what to fix. |
| Billing Webhook URL | Called when a client saves a new card. |
| Payment Webhook URL | Called when an invoice is paid online. |
Clients then pay from the invoice's payment link or its Pay Now button.
Settings → Invoicing Settings shows the same payment settings on one page, for your newest layout set.
Tax and currency¶
Under Settings → General:
- Invoice prices are — whether the prices you type include tax: Tax exclusive, Tax inclusive or No tax. New documents and recurring invoices start with this; you can change it on each document.
- Default Currency — the currency amounts are shown in.
Tracking categories¶
Tracking categories sort invoice lines for reporting — by department, region or job type — and carry through to Xero. Settings → Tracking Categories holds up to two, each with as many options as you need.
![]()
Click Add Category, name it, and add its options. Once you have one, each line on a quote or invoice gets a column for it.