Skip to content

Set up invoicing

Who can do this

View Invoices to see these settings. Manage Users to change layout sets, Online payments and the rest of Invoicing Settings, including the default layouts, payment terms, numbering and your details. Edit Invoices to change Standard Line Items. Without the right, the page says it's read-only and which right you need. Adding Stripe or Paystack, from the layout set or App Connections, adds an app connection, so it also needs Create and change automations.

A layout decides what every client sees and where their payments go, which is why it needs Manage Users. Every change to a layout or its payment settings is recorded with who made it, when, and what it was before.

The settings for quotes and invoices are under Settings → Accounting. Most are in Invoicing Settings, in its first section, Quotes, invoices & credit notes.

Quotes, invoices & credit notes

The first section of Settings → Invoicing Settings. These settings used to be in Settings → General, under Accounting. There's no Save button: each setting saves as you change it, for the whole account.

Setting What it does
Quotes use, Invoices use, Credit notes use The layout set each kind of document starts on. See Default layouts.
Invoice prices are How a new quote or invoice treats tax: Tax exclusive (the prices you type are before tax; tax is added on top), Tax inclusive (the prices you type already include tax) or No tax. It's only the starting point: you can choose differently on any one document, and documents you've already made keep what they had. See Tax and currency.
Round tax On each line, or On the invoice total (as QuickBooks and most till systems do). Applies to quotes and invoices saved from then on.
Payment terms How long after its date an invoice is due: same day, 1, 7, 14, 15, 30, 45, 60 or 90 days, or another number of days. 7 days until you choose. New invoices start with this due date. See Payment terms.
A client's own payment terms A client field holding a client's own terms, such as Net 30, used instead for that client.
Next number Where your quote, invoice and credit note numbers carry on from. See Numbering.
Your address, Tax / VAT number, Company registration number Printed on quotes and invoices whose layout has Your Address, Tax and Registration Numbers. See Your details on documents.
Statement footer Printed at the bottom of every statement: your bank details and how to pay.

Default layouts

Quotes use, Invoices use and Credit notes use each pick one of your layout sets, or No default.

  • When nobody picks a layout, a new document starts on its kind's default: in the CRM (once you choose Quote or Invoice), by an automation, by an AI app, by an import, or as a recurring invoice. With no default, a quote or invoice starts on the top layout set in Settings → Quote/Invoice Layout, and a credit note takes the layout of the invoice it credits.
  • When a quote becomes an invoice, it moves to the Invoices use layout. That's the same however it's converted: by hand or in bulk, paid online by the client, or by an automation or an AI app. With no invoice default, it keeps the quote's layout.
  • After that, a document keeps the layout it was last given. Change it by hand or with an automation, and it stays.
  • Changing a default never changes documents you've already made.

Keep changing the layout on new documents? Set the default from the document itself, with the menu beside its Layout list: see Make a quote or invoice. Deleting a layout set that's a default sets that kind back to No default.

Payment terms

In Settings → Invoicing Settings, under Quotes, invoices & credit notes:

  • Payment terms — how long after its date an invoice is due: Same day (due on receipt), 1, 7, 14, 15, 30, 45, 60 or 90 days. For any other number, choose Another number of days… and type it (0 to 365). Until you choose, it's 7 days.
  • A client's own payment terms — pick a client field that holds a client's own terms, such as 30 or Net 30. When a client has it filled in, their invoices use it instead. A value that isn't a number of days is ignored, and the account's terms apply.

A new quote or invoice in the CRM starts with its Due date filled in from these terms, so you can see it before saving. Payment terms set the due date of every new invoice made without one: in the CRM, by a quote turning into an invoice, by a recurring invoice, a workflow, an AI app or the API. Invoices you've already made keep their due date. A quote stays valid for 7 days unless you pick another date.

Numbering

Quotes, invoices and credit notes share one run of numbers: QU1024, INV1025, CN1026.

Next number, in Settings → Invoicing Settings under Quotes, invoices & credit notes, sets where it carries on from. Moving from Xero or QuickBooks? Set it to one after your old system's last invoice, such as 1001. Numbers only go up: a number lower than one you've already used has no effect. Leave it blank to carry on from your highest.

A document brought over with the Accounting task or the API can keep its old number when no document in the account has it yet.

Your details on documents

In Settings → Invoicing Settings under Quotes, invoices & credit notes, fill in what prints on every quote and invoice whose layout has Your Address, Tax and Registration Numbers ({{sender_details}}):

  • Your address
  • Tax / VAT number
  • Company registration number

Leave one blank and it isn't printed. Statement footer, beside them, prints at the bottom of every statement: your bank details and how to pay.

South Africa: tax invoices

With a VAT number filled in, a South African account's invoices print as Tax Invoice, with your VAT number, as SARS requires (use {{document_title}} in your layout). Quotes and credit notes keep their own titles.

How documents look

Settings → Quote/Invoice Layout holds your layout sets. A layout set is a design for the PDF. 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.

Editing the Neverland Home Services layout set: Layout Name, the Template tab with the HTML template in an editor and a Preview PDF button, and the list of variables — Invoice, Client, Client Custom Fields and Your Company — down the right

  • Add makes a new layout set from the standard design. It goes to the bottom of the list.
  • Drag a layout set by its handle to change the order. The order is the same in the Layout list on a document. The top one is marked Default:

    • a new quote or invoice starts on it when its kind has no default layout;
    • a quote or invoice whose layout set was deleted prints with it.

    Moving a different layout set to the top changes both. Every other quote and invoice keeps the layout set it was made with, so old ones never change. If you delete the top layout set, the next one down takes its place. - Any layout set can be the default for quotes, invoices or credit notes: choose it in Settings → Invoicing Settings, under Default layouts. - 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 (see What a layout can print). 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. - An Attachment field prints the names of the client's files in it, one per line. Each name is a link, so whoever reads the PDF clicks it to open the file — a site plan, a signed contract, the photos of a job. Anyone with the PDF can open those files, so only put a field on the layout if its files are meant for the client. - A Signature field prints the client's signature itself — about a signing line tall at most, and never wider than the space it's in. Until the field is signed it prints nothing, so a label you type in front of it, such as Accepted by:, shows on its own with a blank after it. Preview PDF shows a made-up signature where it lands. If the signature can't be fetched at that moment (rare, and brief), that one copy prints with the space blank, and the document's saved PDF isn't replaced, so a signed PDF you've already sent stays as it was. Opening it again tries again. - Reference ({{reference}}) prints the document's Reference, such as its number in your old system or the client's order number. On a document without one it prints nothing, so a label you type in front of it, such as Ref:, would show on its own. - Preview PDF shows the design filled in with sample values, in your currency and tax setting. Choose what to preview it as beside the button: Invoice, Invoice, part paid, Invoice, paid, Quote or Credit note.

A layout with anything a printed page can't use (scripts, forms, frames, embedded pages and the like) isn't saved: BaseCloud says what to take out. Pictures must be https:// links or embedded images; a plain http:// link, or an address on a private network, doesn't load.

What a layout can print

Variable Placeholder Prints
Line Items {{line_items}} The lines table. A Discount column appears when a line has a discount, and quantities print as entered, such as 1.5.
Sub Total, Tax, Total {{subtotal}}, {{total_vat}}, {{total}} With your currency symbol: $1,234.50, R1,234.50.
Tax by rate (table) {{tax_summary}} One row per tax rate: what it was charged on and the tax. With your books on, each rate shows its own name, such as a state or county rate.
Tax name {{tax_label}} What tax is called for your currency: VAT (South Africa and other VAT countries), GST, or Tax (the United States). Column headings use the same word.
Document Title {{document_title}} Quote, Invoice, Tax Invoice or Credit Note.
Document Number {{quote_invoice_o_id_full}} INV1024, QU1024 or CN1024.
Reference {{reference}} See below.
Document Date {{date_created}} With its label: Invoice Date or Quote Date.
Due Date {{expiry_date}} While unpaid, with its label. On an open quote it reads Valid until.
Date Paid, Status {{date_paid}}, {{invoice_status}} When it was paid; Payment Due, Paid, Credited, Void, or Open on a quote.
Amount Paid, Balance Due {{amount_paid}}, {{balance_due}} What has been paid, and what is still owed.
Payments Received (table) {{payments_table}} One row per payment and credit.
Credit Note Reason {{credit_note_reason}} Why a credit note was made. A layout without it prints the reason on the credit note's status line.
Pay Now Button {{pay_button}} A button to the payment page, while a balance is due and online payment is set up.
Your quote and invoice fields {{invoice_field_<id>}} Any of your quote and invoice fields, on the documents it is on.
Client Name, Client Number {{client_name}}, {{o_client_id}} The client's.
Your client fields {{client_field_<id>}} Any of your client custom fields.
Your Company Name {{company_name}} Your company.
Your Address, Tax and Registration Numbers {{sender_details}} All three details, one per line. Each also has its own placeholder: {{sender_address}}, {{sender_tax_number}}, {{sender_registration_number}}.

A placeholder must be spelled exactly as shown. One BaseCloud doesn't know prints as typed, braces and all. Text a client or you typed, such as a line's description, prints as text: it can't change the layout.

Total, Sub Total and Tax print with your currency symbol and commas 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&amp;receiver=12345678&amp;item_name=Invoice+{{quote_invoice_o_id_full}}&amp;amount={{total_raw}}">Pay now</a>

A connected AI app can read, change, preview and add layout sets for you, choose your default layouts, 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. On a US dollar account using Stripe, clients can also pay from a US bank account (ACH): switch on US bank account as a payment method in your Stripe account. See Take payment online.

Online payments are set once for your whole account: every quote and invoice layout uses them.

Settings → Invoicing Settings → Online payments shows what happens when a client pays: they pay by card from the invoice email or link, the money goes into your Stripe or Paystack account, the invoice is marked Paid by itself, and your team hears about it (a note on the client, and your "invoice paid" automations run). Paid less shows as part paid, paid more is kept as the client's credit, and refunds you make in Stripe or Paystack are recorded too.

Once a gateway is chosen, a short checklist takes you through the rest, with a progress bar and a badge at the top: Taking payments when it's all done, or how many steps are left.

  1. Open Settings → Invoicing Settings, at Online payments.
  2. Choose your Stripe or Paystack connection under Payment gateway. Not connected yet? Click Add a gateway (or + Add a gateway at the bottom of the list), pick Stripe or Paystack, and paste its secret key: the same steps as Settings → App Connections & Keys. The new connection is chosen straight away.

    The form says where the key is, with a button that opens the page:

    • Stripe: Developers › API keys, then Secret key under Standard keys. Click Reveal live key, or Create secret key if that's what Stripe offers (it shows a new key only once, so copy it straight away). It starts with sk_live_.
    • Paystack: Settings › API Keys & Webhooks, then Live Secret Key. It starts with sk_live_. If you only see test keys, finish activating your business in Paystack first.

    The secret key is the only one BaseCloud needs: not the publishable or public key. 3. Connect your key is ticked once the connection has its secret key. It shows Saved; click Replace key to paste a new one. 4. Tell Stripe (or Paystack) where to report payments. With Stripe, BaseCloud adds its webhook to your Stripe account by itself when you choose the gateway, with every event it needs, and saves the signing secret. It says so in this step; Set it up in Stripe for me does it again. If it can't (a restricted key without webhook access), or with Paystack, copy the Payment Webhook URL shown there and add it to your provider, as below. Once it's added, a payment marks the invoice Paid by itself, recorded as Online payment (Stripe) or (Paystack): see Take payment online. Without it, the client's payment goes through but the invoice is never marked paid. Click How to add it in Stripe (or Paystack) for the steps. 5. Check it works: click Test payment setup. BaseCloud asks your provider whether everything works, and says what to fix if anything doesn't. Nothing is charged. When it passes, steps 2 and 3 are ticked, the page says You're taking payments online with the day it was checked, and it stays that way when you come back. Paste a new key or signing secret, or choose another gateway, and the checklist asks you to test again.

Test your payment setup

Test payment setup, in the Check it works step, 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, which of the other events aren't ticked and what that costs (without checkout.session.async_payment_succeeded, US bank payments are never marked paid), 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.

Paystack gives no way to read its webhook address, so for Paystack a passed test is what ticks the Tell Paystack where to report payments step. Check that the address is in Paystack before you rely on it.

Secret key sits in the first step, 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

  1. In BaseCloud, click the Payment Webhook URL to copy it.
  2. 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.
  3. Search for Webhooks at the top of Stripe and open it (it is under Developers), then click Add destination.
  4. Stripe asks which events to send. Leave Your account selected. In the event search box, find and tick each of these, then click Continue:

    Event What it tells BaseCloud
    checkout.session.completed A client finished paying.
    checkout.session.async_payment_succeeded A US bank (ACH) payment cleared.
    checkout.session.async_payment_failed A US bank payment failed.
    charge.refunded You refunded a payment in Stripe.
    charge.dispute.created A client's bank disputed a payment.
    charge.dispute.closed A dispute was decided.
  5. Choose Webhook endpoint as the destination type and click Continue.

  6. Paste the address into Endpoint URL and click Create destination.
  7. On the page that opens, find Signing secret, click Reveal, and copy it. It starts with whsec_.
  8. Back in BaseCloud, paste it into Webhook Secret. It saves by itself.

Already have a Stripe destination? Open it, click Edit destination, check the URL matches exactly, and tick any of the events above that are missing. 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

  1. In BaseCloud, click the Payment Webhook URL to copy it.
  2. Sign in at dashboard.paystack.com and click Settings at the bottom left.
  3. Open the API Keys & Webhooks tab.
  4. Paste the address into Live Webhook URL, not the Test one.
  5. Scroll down and click Save changes.

That's all. Paystack sends every payment, refund and dispute 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

When updates from Stripe or Paystack fail, your admins get a note in BaseCloud, once a day, until it's fixed. 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; a payment resent is recorded once.

Saved cards

A card is saved only when the client ticks Save this card for future payments on the payment page; then BaseCloud calls your When a client saves their card address, if you've set one. The payment page never shows or charges a saved card: a saved card is charged by a workflow's Charge Account task. 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.

Online payments in Invoicing Settings: the payment gateway with its status, what happens when a client pays, and the three setup steps; then Client payment page and Send payments to your own system

Setting What it does
Payment gateway The Stripe or Paystack connection clients pay through, for every layout. Until one is chosen, the page shows what online payments do, and nothing else below it.
1. Connect your key The chosen connection's Stripe or Paystack secret key: Saved, with Replace key to paste a new one when you roll it. See above.
2. Tell your provider where to report payments The address to add to Stripe or Paystack, with How to add it for the provider you chose. One address serves every layout. See above.
Webhook secret (in step 2) Stripe only: its 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 — paste a new one to replace it.
3. Check it works (Test payment setup) Checks the key, the webhook and the secret with your provider, and says what to fix. A pass is remembered, with the day.
When a client opens a quote Pay it (paying accepts it), the default: the quote's page shows the payment form and no Accept button. Paying the quote accepts it and turns it into an invoice. Accept shows only when the quote can't be paid online, for example when it totals zero. Accept it only, without paying: the client types their name to accept the quote and pays nothing on its page. A payment link that asks for part of the total now (a deposit) still takes payment. Invoices are paid online either way. See Quotes on the payment page.
Ask the client to agree to your terms first The client must agree to your Consent text before paying. The box for the wording shows once this is ticked.
Link to your terms Optional. The web address of your terms, shown on the payment page.

Send payments to your own system (for developers) is folded away at the bottom: most businesses leave it empty. If another system of yours needs to know, click it and enter its Web address (URL). Each must start with https://, so the details travel encrypted; anything else isn't saved, and the box says why.

Address When BaseCloud sends to it
When an invoice is paid online A client pays an invoice through Stripe or Paystack: BaseCloud sends the payment (a POST with the client, the invoice and the amount). Not the address you give Stripe.
When a client saves their card A client ticks to save their card: BaseCloud sends the client's email, the card type, the bank and the last four digits, never the full card number.

Clients then pay from the invoice's payment link or its Pay Now button. Without a gateway, Payment Link is greyed out and PDFs leave out Pay Now.

Settings → Invoicing Settings is also where you set up your Payment Methods: rename, reorder or switch off the usual ones, and add your own, such as Venmo or Zelle. See Your payment methods.

Agreements your clients sign

Have clients read and agree to an agreement of yours, such as a maintenance plan or a service agreement, on their quote or invoice before they pay or accept it. In Settings → Invoicing Settings, under Agreements:

  1. Click New agreement. Give it a name, write it (headings, paragraphs, bold, lists, tables and links are kept; pictures, colours, fonts and alignment are taken out when you save), and write the words of the tick at its bottom, such as I have read this agreement in full and agree to it. Links in it open in a new tab, so the client keeps their quote or invoice open.
  2. Fill in who signs for your business, and its Term: how many months it runs, the days' notice a client gives not to renew, and whether it renews by itself. The client sees them before agreeing, and they are printed on the signed copy, when the quote or invoice does not say otherwise. Each signature keeps the term as it was on the day it was signed. Click Save.
  3. In Clients sign, choose the agreement, and how often: Once, and again when you change it, or On every quote and invoice.

Type these where you want them in the agreement, as often as you like. What the client signed for and the signatures always appear: if you leave either out, it is added at the end.

Type What goes there
{{order_form}} What the client signed for: the quote or invoice's number, date, lines, total and term. The client sees it before agreeing.
{{signatures}} The client's signature (name, email, company, the day and time, IP address) and the name and title of whoever signs for your business.
{{effective_date}} The day it was signed. Only where you type it.

On the quote or invoice's page, the client clicks Pay or Accept (or Read and sign), reads the agreement, types their name and email, ticks the box and clicks Agree. Their payment or acceptance then goes on. They can't pay or accept until they've agreed. They get a signed copy (a PDF) by email from the client's person responsible, and it's saved on their Files tab. A client with no person responsible gets no email: the copy is still on their Files tab, and a note tells you to send it. Only a quote or invoice with something to pay or accept asks: never a paid invoice, an accepted quote, a credit note or a void document.

Changing an agreement. Until a client has signed it, changes are saved in place. A client who opened the agreement before you changed it is asked to read it again when they click Agree. Once a client has signed, the version they signed is kept exactly as it was, and different words, a different tick or a different signatory are saved as the next version: clients who signed the earlier one are asked to sign the new one on their next quote or invoice. Give the new version a name (such as 2.2) in New version's name, or it takes its number; two versions can't share a name. Changing only a version's name never makes a new version. The term, renewal and notice change straight away for signatures from then on. Earlier versions are listed at the bottom of the agreement to read. An agreement your clients sign can't be archived; choose another, or None, first.

Your Consent text still shows on the payment page beside it. Link to your terms and its tick are not shown while clients are asked to sign an agreement.

Tax and currency

Under Settings → Invoicing Settings, in Quotes, invoices & credit notes:

  • Invoice prices are — whether the prices you type include tax: Tax exclusive, Tax inclusive or No tax. New documents, recurring invoices, workflows, AI apps and the API start with this; you can change it on each document.
  • Round tax — On each line, or On the invoice total (as QuickBooks and most till systems do: a cent of difference goes on the largest line). It applies to quotes and invoices saved from then on.
  • Default Currency, in Settings → General — the currency amounts are shown in.

Tracking categories

To sort invoice lines for reporting — by department, region or job type — add a single choice line field in Settings → Quote & Invoice Fields under Line fields, with an option for each department, region or job type. Add as many as you need. Every report can then split or filter your lines by it. See Sort your lines for reports.

If you had tracking categories before, they were moved into line fields of the same name, with the same options, and every line kept its answer. Workflows that used them keep working.

Start again with a clean slate

Testing BaseCloud with made-up quotes, invoices and payments before moving your real ones over (from QuickBooks, Xero or another system)? BaseCloud support can clear them out first, so the move brings everything in once with nothing left over to duplicate. Ask support, and say what to clear:

  • Quotes
  • Invoices and credit notes, which takes their payments with them
  • Payments, refunds and credit on their own; invoices you keep go back to unpaid
  • with books: manual journals, bank statements and bank transactions (your bank accounts and bank rules stay), the opening balances you typed, or the books entirely (see Remove your books)

What's cleared is deleted for good: it doesn't go to Recently deleted and can't be brought back. Your clients, Pricebook, layouts, recurring invoice settings and automations stay, no automation runs, and your clients aren't told. Payments your clients made online by card are only deleted from BaseCloud: nobody is refunded. While your books have a lock date, clear it first (or remove the books too).

Numbering then carries on from the highest number left (quotes you kept count), or from Next number under Numbering when that is higher. With nothing left and no Next number, it starts again at 1.