Currency conversion¶

4Geeks can process charges in multiple currencies, but your payouts settle in the currency of your account. When those two currencies differ, a conversion happens automatically.

Summary

When it applies: only when you use 4Geeks Payments as a gateway in production.
What it converts: the collection currency to your account currency.
What it costs: 4Geeks adds no extra fee to the reference rate.

Who it's for
Teams with international sales

Time
3 minutes

Level
Intermediate

Result
Understand when and how a charge is converted

When does a conversion happen?¶

A conversion occurs when the collection currency (what the customer pays) is different from the settlement currency (the currency of your account).

flowchart LR
  A[Cliente paga en EUR] --> B{¿Moneda de cuenta?}
  B -- EUR --> C[Sin conversión]
  B -- USD --> D[Conversión automática]
  D --> E[Liquidación en USD]

Collection currency	Settlement currency	Result
USD	USD	No conversion
EUR	USD	Converted to USD
CRC	CRC	No conversion
MXN	USD	Converted to USD

How the reference rate works¶

4Geeks uses a standard reference rate based on international indices and banks.
Values are refreshed once or twice per day.
4Geeks does not add an extra fee on top of the reference rate.

Estimates, not a guarantee

The reference rate is useful for planning and reconciliation. The final amount can vary slightly between the estimate and the moment the charge is processed.

Check the reference values¶

Use the countries endpoint to see the current reference values, where 1 USD is expressed against each currency:

curl -X GET 'https://api.4geeks.io/manager/countries/' \
  -H 'X-Api-Key: sk_test_your_api_key_here'

Values are updated once or twice per day.
Use them to estimate payouts and reconcile reports.
Do not hard-code rates in your application.

What this means for your reports¶

Charges keep the currency the customer paid.
Payouts show the currency you received.
Conversion appears as the difference between the two.

FAQ¶

Does 4Geeks charge a conversion fee?

No. 4Geeks does not add an additional fee to the reference conversion rate. Your agreement may still include standard processing fees.

Can I settle in a currency different from my account currency?

Your account has a settlement currency. If you need a different one, contact support before going live.

Why is the final amount different from my estimate?

The reference rate is updated once or twice per day and the rate applied at processing time may differ slightly.

Still have questions? Ask on Discord or explore the tutorials.