Converting Invoices to a New Currency

From WHMCS Documentation

Revision as of 18:06, 14 January 2022 by SarahK (talk | contribs) (Created page with "It is possible that not every gateway you use will accept all the currencies you offer on your site. Many gateway modules support a '''Convert To For Processing''' option so W...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

It is possible that not every gateway you use will accept all the currencies you offer on your site. Many gateway modules support a Convert To For Processing option so WHMCS can transparently convert the payment amount into a different currency before sending the client to the payment gateway.

Convert invoice amounts into a different currency

By configuring multi-currency in WHMCS, you can offer prices in multiple currencies even if your chosen payment gateway only operates in one currency.

For example, you could use a gateway that only operates in USD but use this feature to also offer prices in USD, GBP and EUR. When a client places an order and chooses that gateway, the system would automatically convert the amount to the gateway's currency before processing. Without this feature, the client would not be able to use that gateway.

Note
The system performs the currency conversion using the Base Conversion Rate in your WHMCS installation at the time of payment.

To configure this feature:

  1. Configure at least two currencies at Configuration () > System Settings > Currencies.
    Note
    The required Convert to For Processing setting for payment gateways only displays if you have configured at least two currencies.
  2. Go to Configuration () > System Settings > Payment Gateways or, prior to WHMCS 8.0, Setup > Payments > Payment Gateways, and click Manage Existing Gateways.
  3. Set Convert to For Processing to your desired currency (the currency the gateway requires).
  4. Click Save Changes.

The system will send all payments to this gateway in the chosen currency, regardless of which currency the client selected on the order form.