docs
FeaturesInvoices

Invoice settings

Numbering, defaults, tax rates, the PDF, emails and SMS limits, reminders, templates, team notifications and who can do what.

Open Settings, then Invoices. The page has three tabs: General, Emails and reminders and Templates. Click Save changes when you are done. On General, a sample invoice beside the settings updates as you change them.

General

Business details and branding

The name, address, tax registration number and commercial registry number on every invoice come from Settings, then Business. The same page holds your support email, phone and website, which customers see on invoices, emails and receipts. Invoice emails are sent by XPay, so add a support email for your customers' questions.

Your logo and brand colour come from Settings, then Branding. Invoices, their emails, receipts and the pay page all use them. There is no separate invoice colour.

Invoice numbers

Every issued invoice gets the next number in one unbroken sequence, such as INV-000127. A draft has no number until it is issued.

Click Edit to change the Invoice prefix (1 to 12 letters or digits) or the Next invoice number, for example to carry on from the numbers you used before XPay. Numbers can only go up, so a number is never used twice.

Credit notes are numbered from their invoice: the first credit note on INV-000127 is INV-000127-CN1, the next INV-000127-CN2.

A voided invoice keeps its number. Test mode and live mode each have their own sequence.

Defaults for new invoices

What a new invoice starts with. You can change any of it on each invoice.

SettingWhat it sets
Payment termsDue on receipt, due in a number of days, or Custom with any number of days from 0 to 365.
Default memoShown to the customer on the invoice and in the email.
Default footerPrinted at the bottom of every page, for terms or legal text.
Custom fieldsUp to 4 extra details printed at the top of the invoice, such as a PO number.
Default tax ratesApplied to every new item automatically. Up to 5.
Tax roundingRound on each item or Round once per invoice.

A default template replaces the memo, footer and custom fields on new invoices. The two rounding choices give the same total on most invoices. They can differ by a piastre or two when an invoice has many small items.

Tax rates

Save each tax once and add it to invoices. Click Add tax rate and set:

  • Name. Printed on invoices beside the tax amount, such as VAT. You can add an Arabic name for Arabic invoices.
  • Percentage. Above 0 and up to 100, with up to 4 decimal places.
  • Prices include this tax. On means the tax is already inside the price. Off means it is added on top.

The percentage and whether prices include the tax cannot change after the rate is created, so issued invoices never change. Only the name can change, with Rename.

To change a rate, Archive it and add a new one. An archived rate stays on existing invoices but cannot be added to new ones. Restore brings it back.

Payment methods

How customers can pay a new invoice online:

  • Every payment method I have enabled. New invoices follow your payment method settings as they change.
  • Only the methods I choose. Pick from the methods enabled on your account.

Invoice PDF

  • PDF language. Arabic, English, or Arabic and English, which prints both side by side.
  • Page size. A4 or Letter.

Each part of the PDF shows when it has something to show: your tax and registry numbers when you have them, the shipping address when it differs, units and the tax column when an item uses them. Every unpaid invoice carries the link and QR code to pay.

Emails and reminders

Send invoices by

New invoices always go by Email. Turn on Also send by SMS to send a short message with the link to pay too. You can change this on each invoice.

Reminders go the way their invoice was sent: by email if it was emailed, and by SMS on the due date and the first reminder after it if it was sent by SMS while Also send by SMS is on. An invoice whose link you share yourself gets no automatic reminders.

Every invoice email and SMS carries the link to pay while the invoice is unpaid.

SMS limits

SMS is limited in three ways.

LimitRule
Per invoiceUp to 3 automatic SMS messages, plus up to 2 that you send by hand.
Per phone numberA phone number gets at most 2 invoice SMS messages a day, counting every business on XPay together.
Per monthYour SMS credits. They start again on the first day of each month.

An SMS in English uses 1 credit and an SMS in Arabic uses 2, because Arabic needs more space. The SMS tab of the invoice preview shows how many credits a message uses.

You get 200 credits a month unless XPay set a different number for your account. SMS credits beside the switch shows how many you have used this month and about how many English or Arabic messages are left. When they are used up, SMS messages stop until next month and emails still go out.

SMS goes only to a mobile number. When an SMS is not sent, the invoice's Activity says which limit stopped it.

PDF attachment

Attach the PDF to invoice emails sends the invoice PDF with the email. The customer can always download it from the pay page too.

Reminders

One schedule for every reminder: the days before, on and after the due date. Each reminder goes the way its invoice was sent. Up to 10 reminders, each on a different day, from 60 days before the due date to 180 days after. Remove them all to send no reminders. You can still stop reminders on a single invoice.

Automatic reminders go out between 09:00 and 22:00 Cairo time. See Automatic reminders for the full rules.

Notices

Switch off Invoice cancelled or Credit note if you prefer to tell the customer yourself. The New invoice link a customer asks for when their link has expired is always sent. Payment receipts follow your Customer emails settings.

Write off

Choose Never write off automatically, or write invoices off after 30, 60 or 90 days overdue. A written-off invoice is marked uncollectible and reminders stop. The customer can still pay it.

Templates

A template is a saved set of memo, footer, custom fields and PDF language for a kind of invoice you send often.

Click Add template, give it a Template name, and fill in what it should carry. Turn on Use for new invoices to make it the default: new invoices start from it unless you pick another.

In the invoice editor, choose the template under More options. Deleting a template does not change invoices already made from it.

Team notifications

Your team can be emailed about invoices. Each person sets their own in Settings, then Notifications, on the Transactions and Balances tab under Invoices.

NotificationSent whenOn by default
Invoice paidAn invoice is paid in full.Yes
Invoice partly paidA payment arrives and an amount still remains.Yes
Invoice overdueAn invoice passes its due date unpaid.Yes
Invoice payment failedAn online payment on an invoice does not go through.No
Scheduled invoice could not be sentA scheduled invoice could not be issued at its time.Yes

They go to the Super Administrator, Administrator and Accountant roles, by email.

Who can do what

Invoices follow your team's roles.

RoleInvoicesTax ratesRefund through a credit note
Super AdministratorView and manageView and manageYes
AdministratorView and manageView and manageYes
AccountantView and manageView and manageYes
Sales RepresentativeView and manageView onlyNo
Support AgentView onlyView onlyNo
DeveloperView onlyView onlyNo
View OnlyView onlyView onlyNo

Managing invoices covers creating, sending, recording payments, issuing credit notes, voiding and changing invoice settings.

Giving money back is a separate permission. A credit note that refunds money needs both the invoices permission and the refunds permission. A Sales Representative can issue a credit note that lowers what is owed or gives customer credit, but not one that refunds. A Support Agent can refund a payment from its own page, but cannot issue a credit note.

For API keys, the matching permissions are Invoices, Tax rates and Refunds, each with Read and Write.

Where to next

On this page