Back

Printing the Client and Supplier Payment Receipt in the Actual Payment Currency

When a payment is recorded in a currency other than the invoice currency, the client’s Payment Receipt and the supplier’s payment receipt are printed in the currency the amount was actually paid in, along with its code. This is determined automatically from the payment data, with no setup required. A line is also added showing the currency and the exchange rate used.

Required PermissionsThe permission to view and print the payment.
How to AccessClient Payments or Suppliers Payments → open the payment → Print

What Changes on the Printout?

Element Before Now (payment in a different currency)
Amount In the invoice currency The amount actually paid, in the payment currency and with its number of decimal places
Amount in words In the invoice currency In the payment currency
Currency code Invoice currency Payment currency
Explanatory line below the treasury line Not present Amounts shown in [currency] — Exchange rate used: 1 [payment currency] = [rate] [invoice currency] as of [payment date]

Placeholders in Custom Templates

If you use a custom payment receipt template, add the following placeholders from the template editor:

Placeholder Name in the editor Value
{%payment_currency_note%} Amounts shown in [currency] note The full explanatory line (currency, exchange rate, and date); empty for payments made in the invoice currency
{%payment_exchange_rate%} Exchange rate used The exchange rate from the payment currency to the invoice currency, with six decimal places; empty for payments made in the invoice currency
{%amount%} and {%spelled_amount%} Amount / Amount in words Now displayed in the payment currency

What Doesn’t Change

  • The payments table inside the printed invoice itself stays in the invoice currency, because the invoice is displayed in its own currency.
  • Payments made in the invoice currency and old payments print exactly as before, without the explanatory line.
  • The change covers both sales invoice payment receipts and purchase invoice payment receipts, with the same texts.

Example of the Printed Line

For a payment of 375 riyals against an invoice in US dollars, dated 15/10/2026, this appears below the treasury line: Amounts shown in SAR — Exchange rate used: 1 SAR = 0.266667 USD as of 15/10/2026.

How Does the System Determine the Print Currency?

  • It reads the payment currency and the collected amount saved with the payment.
  • If the payment isn’t in a different currency, the receipt prints as before.
  • The amount prints with the number of decimal places of the payment currency, not the invoice currency.
  • The explanatory line appears only if the invoice currency and the conversion rate are known.

Default and Custom Templates

Template type Behavior
The default Payment Receipt template Prints the amount in the payment currency and the explanatory line automatically
The default supplier payment receipt template Same behavior
Custom template The amount and the amount in words are in the payment currency automatically, and the explanatory line appears only if you add {%payment_currency_note%}
Invoice printing (payments table) In the invoice currency, unchanged

Why Doesn’t the Receipt Show the Payment Currency?

Cause Solution
The payment is recorded in the invoice currency Normal behavior
An old payment from before the update Edit it and choose the payment currency if you want
You are printing the invoice, not the receipt Print from the payment page
A custom template without the note placeholder Add {%payment_currency_note%}

Access and Printing

  1. Open the payment from the invoice page (the Payments tab) or from the payments list.
  2. Click Print or PDF, or send the receipt by email.
  3. Choose the template if you have more than one receipt template.

FAQs

Do I need to enable a setting to print the receipt in the payment currency?

No, it is determined automatically from the payment.

Why is the exchange rate shown with six decimal places?

To show the rate with enough precision to recalculate the settlement.

Does the explanatory line appear in my custom template?

Only if you add the {%payment_currency_note%} placeholder.

Does this cover supplier payment receipts?

Yes, purchase invoice payments are also printed in the payment currency.

Why does the receipt amount differ from the payment amount on the invoice?

The receipt shows what was actually paid in the payment currency, while the invoice shows the settlement amount in its own currency.

Does the currency name change according to the template language?

The currency code is printed as is, and the explanatory texts appear in the template language.

Does the line appear on the receipt sent by email?

Yes, because it is part of the template itself.