Manage Payment Methods on the Account
From the Payment Methods page, you control the payment methods that appear when recording payments on invoices and in the client portal: enabling and disabling them, choosing the default method, linking each method to a treasury, calculating payment fees and their tax, adding custom payment methods, and setting up online payment gateways. This guide also explains how to use the same payment method in more than one branch while depositing each branch’s amounts in its own treasury.
Contents
- Payment method types
- Enable a payment method and set the default
- Payment method settings
- Payment fees
- Add a custom payment method
- Edit and delete a payment method
- Online payment gateways
- Use a payment method in more than one branch
- Payment methods in POS
- Error messages and solutions
- Important notes
- FAQs
Payment method types
Payment methods appear on the page as cards grouped into three categories:
| Category | Content |
|---|---|
| Manual Options | The system’s basic methods, such as cash, bank transfer, and cheque. They can’t be deleted. |
| Online Payment Gateways | Online payment gateways that clients pay through online. The available ones depend on the account’s country. |
| Custom Payment Methods | Methods you add yourself with a name of your choice. They can be edited and deleted. |
Each card has: the enable switch, the Default star, and a Manage link to open its settings.
Enable a payment method and set the default
- Click Settings in the main menu, then Payment Methods.
- Turn on the enable switch on the payment method card; its settings window opens so you can review and save it.
- To make the method the default choice in payment forms, click the Default star on its card.
- Click Save at the bottom of the page; the message Payment options saved appears.
- An inactive method doesn’t appear on payment recording screens, and it can’t be made the default (the star is disabled when it’s turned off).
- Only one default method is allowed; choosing a new star cancels the previous one.
- The default method is used automatically when adding a payment on an invoice, an advance payment, credit and debit notes, refunds, and the payment page, and on the client’s online payment page.
Payment method settings
Click Manage on the method card to open the Settings window, which contains:
| Field | What it does |
|---|---|
| Default Treasury | The treasury or bank account where this method’s amounts are deposited. It applies fully to online client payments and API payments, while employee payments are subject to treasury permissions, as in the section Use a payment method in more than one branch. |
| Enable for Online Clients | Enabled: the method appears to the client when paying their invoices from the client portal. Disabled: it appears to employees only. |
| Instructions | Guidance text about the payment method (such as the bank account details for a transfer). |
| Payment Fees | Calculate to charge a commission on each payment, or Off. Details are in the next section. |
🛈
Note: The Enable for Online Clients option only controls whether the method appears to the client; employees see all active methods in payment forms regardless of it. The credit payment method is always disabled for clients.
Payment fees
Payment fees are used to record bank and payment gateway commissions automatically. When you choose Calculate, the following fields appear:
| Field | Description |
|---|---|
| Type | Percentage or Fixed Amount. |
| Percentage | A percentage calculated from the payment amount. You can add a Fixed Amount with it at the same time. |
| Fixed Amount | An amount deducted from each payment. |
| Minimum Amount | The minimum commission; if the calculated commission is less than it, the commission is charged at this value. |
| Taxes | A tax on the fees themselves (it appears if you have taxes defined), and it affects the tax reports. |
Example
In accounting: the commission amount is recorded in the Payment Fees account (under expenses, with a separate account for each payment method), the commission tax in the tax account, and the amount deposited in the treasury is reduced by the commission and its tax.
🛈
Note: The commission settings are saved with each payment when it’s recorded; changing the percentage or amount later doesn’t change previously recorded payments.
Add a custom payment method
- On the Payment Methods page, click New Custom Payment Method.
- Enter the Name, and you can add Instructions.
- Set Enable for Online Clients.
- Choose the Default Treasury and set the Payment Fees, if any.
- Set the Status: Active or Not Active, then save.
- The name is required, and you can’t repeat the name of an existing payment method.
- You can’t use the name of one of the system’s own payment methods; add a word before or after the name (such as “Cash – Jeddah Branch”).
Edit and delete a payment method
- All methods have their settings edited from Manage, while the name can be edited for custom methods only.
- Deletion is available for custom methods only, from the delete icon in their window, with the confirmation message Are you sure you want to delete this payment method?
- You can’t delete a payment method used in any recorded payment; turn it off instead.
- Manual payment methods and online payment gateways can’t be deleted; they can only be turned off.
Online payment gateways
- In the Online Payment Gateways category, click Manage on the gateway card.
- Enter the connection details you got from the service provider (such as the secret key or merchant ID). Some gateways have a Test Connection button to check before saving, and some are connected by signing in to the provider account.
- Choose the treasury and payment fees, then enable the gateway and save.
- Only the gateways suitable for your account’s country appear (such as Tabby in Saudi Arabia).
- An active gateway appears to the client on the invoice payment page in the client portal.
- Required fields in the connection details show the message “… is required” if they’re left empty.
Use a payment method in more than one branch
Payment methods are account-wide, not per branch: the same methods appear in all branches, each method has one Default Treasury, and there’s no setting to link a payment method to specific branches. However, the treasury where a payment recorded by an employee is deposited is determined by their treasury permissions, so you can make each branch deposit in its own treasury.
How the deposit treasury is determined when an employee records a payment
- If the employee has the Deposit permission for the payment method’s default treasury, the payment is deposited in it.
- Otherwise, it’s deposited in the employee’s own Default Treasury.
- Otherwise, in the main treasury if they have permission to deposit in it.
- Otherwise, in the first treasury they have permission to deposit in.
- If no treasury permissions are set for them, it’s deposited in the main treasury.
Suggested setup: one payment method and a treasury for each branch
- Create a treasury for each branch from Treasuries & Bank Accounts.
- In each treasury’s permissions, grant the Deposit permission to this branch’s employees only by choosing Specific Branch (or Specific Employee / Specific Role).
- From Finance Settings → Employees Default Treasuries, set each employee’s Default Treasury to their branch’s treasury.
- Make the payment method’s Default Treasury in Payment Methods the management’s main treasury, and restrict the permission to deposit in it to management employees; so each branch’s employee payments go automatically to their branch’s treasury.
Example
🛈
Warning: Online client payments from the client portal and payments added through the API are always deposited in the payment method’s default treasury and don’t follow this order. If you need to separate them by branch, use the following alternative.
Alternative: a custom payment method for each branch
Add a custom payment method for each branch (such as “Cash – Jeddah Branch” and “Cash – Riyadh Branch”) and link each one to its branch’s treasury. This makes reports show the payment method by branch, but all the methods will appear in all branches, so the employee must choose their branch’s method themselves.
🛈
Note: When working with branches, the default method may not appear automatically in a branch other than the one it was set from; in this case, the employee chooses the method manually when recording the payment.
Payment methods in POS
- POS uses the same active payment methods, and you choose which methods appear on the sales screen and the default method from POS Settings (the POS default method is separate from the default method here).
- During the session, payments are recorded on the session employee’s custody, and when closing the session is confirmed, they’re transferred: cash to the treasury you choose, and the other methods to each method’s default treasury based on the session employee’s treasury permissions.
- Payment fees are applied to POS payments when the session is closed.
Error messages and solutions
| Message | Reason | Solution |
|---|---|---|
| Please add a name for the payment method | The custom method name is empty. | Enter the name. |
| Error: … has already been added | The name is used for another method. | Change the name. |
| The payment method is reserved for the system, you can add a prefix or suffix to it | The name matches one of the system’s methods. | Add a word before or after the name. |
| You can’t delete the payment gateway because it’s already used in system transactions, and you can deactivate it | The method is used in recorded payments. | Turn it off instead of deleting it. |
| Failed to save payment options | The page couldn’t be saved. | Review the fields and save again. |
| You are not allowed to access this page | You don’t have the permission to edit payment options. | Ask the account manager for the permission. |
Important notes
- Turning off a payment method doesn’t affect payments previously recorded with it.
- If the payment method’s default treasury changes, it applies to new payments only.
- When you close the settings window without saving, the message The changes you made have not been saved yet. appears.
FAQs
How do I link a payment method to more than one branch?
Payment methods are shared across all branches automatically. To deposit each branch’s amounts in its own treasury, assign a treasury to each branch with deposit permission for its employees, and make it their default treasury, as in the section Use a payment method in more than one branch.
Can I hide a payment method from a specific branch?
No. There’s no setting to show a payment method to specific branches. You can turn it off for everyone, or use custom payment methods named after the branches.
Why was the payment deposited in a treasury other than the one set for the payment method?
Because the employee who recorded it doesn’t have the Deposit permission for that treasury, so it goes to their default treasury, the main treasury, or the first treasury they’re allowed to use.
Why doesn’t the payment method appear to the client in the client portal?
Make sure the method is Active and that Enable for Online Clients is set to Enabled.
Does the commission deducted from old payments change if I edit the payment fees?
No. The new settings apply to new payments only.