Converting Invoices to a New Currency

From WHMCS Documentation

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.

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 or, prior to WHMCS 8.0, Setup > Payments > Currencies.
    The required Convert to For Processing setting for payment gateways only displays if you have configured at least two currencies.
  2. Go to the appropriate location for your version of WHMCS:
    • For WHMCS 8.6 and later, go to Configuration () > System Settings > Payment Gateways.
    • For WHMCS 8.0 and later, go to Configuration () > System Settings > Payment Gateways and choose Manage Existing Gateways.
    • For WHMCS 7.10 and earlier, go to Setup > Products/Services > Payment Gateways and choose 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.