R Rafina Panel guide
Guides / Payment and Shipping

Currency Settings

The currency in which you enter prices, how amounts and site digits are displayed, and automatic product pricing with live dollar, gold, coin, and metal rates are set from this page.

Where is it? Rafina Panel → Currency Settings

Currency settings page with two collapsible groups: currency and display, exchange rates and price formula
Two page groups; each row is closed and its current value is written under its title. Click a row to change it.

All changes on this page are saved with the “Save currency settings” button in the bottom bar, except sections that have their own button (rate settings, each row’s manual rate, and the display columns in the header and top bar).

“Currency and display” group

Store currency

Choosing the store currency between Toman and Rial
“Store currency (what unit do you enter prices in?)”.

Toman or Rial. It only tells the system what unit the numbers you type in product prices are in, and that same unit is shown on the site. The WooCommerce currency setting is also written from here and the WooCommerce drawer is locked. Changing it does not change the price numbers. Payment gateways each take their own unit, and conversion is automatic.

WarningIf you enter prices in Toman, don’t set this to Rial; all prices would be read as ten times cheaper.

Currency unit in Google schema

Choosing the Google schema unit between Rial IRR and Toman IRT
“Currency unit in Google schema”.

The price Google shows next to the product in search results is sent in this unit. “Rial (IRR)” is Iran’s official code and Google recognizes it; Toman prices are automatically multiplied by ten. This is our recommendation. “Toman (IRT)” is not an official code, so Google may not show the price and Search Console may report a currency error. Buyers on the site see the store’s unit. Default: Rial (IRR). With an SEO plugin (Yoast or Rank Math), the theme’s product schema stays on.

Unit display and badge size

Choosing unit display as badge or text
“Unit display”.
OptionWhat it does
Unit display: badge (icon)The Toman or Rial symbol replaces the word beside the amount; the page text stays cleaner.
Unit display: textThe word “Toman” or “Rial” is written beside the amount.
Symbol sizeSize 1 (default) to size 5. The size is measured relative to the text beside it, so wherever the amount is larger, the badge is larger too.
Choosing the currency badge size
“Badge size”.

Amounts in the cart, checkout, product page, and product card follow this setting. In invoices, shipping labels, and SMS messages the word always stays because they are plain text.

Currency position beside the price

Choosing the currency position between left of the price and right of the price
“Currency position beside the price”.
OptionWhat it does
Left of the priceLike “125,000 Toman”; the usual Persian form. This is the default.
Right of the priceLike “Toman 125,000”.

The whole site and app follow this: cards, product page, cart, checkout, wallet, and price filter. This setting also replaces WooCommerce’s “Currency position” setting; a store where that option was left on “Left” and saw Toman to the right of the number is fixed with this box.

Site digits

Choosing Persian or English digits for the site
“Site digits (prices, numbers, footer)”.

“Persian digits” to match the page text, or “English digits”, which is what WooCommerce writes by default. Amounts, counters, and the footer’s phone number, address, and working hours all follow this.

“Exchange rates and price formula” group

Currency, gold, and coin rates

Rates section with automatic update switch, interval, service key, staleness threshold, and coin rates table
Rate settings and the top of the rates table (Coin tab).

Rates are fetched from the Rafina service, and the price of products that have a “pricing basis” is built from these rates. The buyer’s page always reads the saved price, so site speed doesn’t depend on the rate service.

OptionWhat it doesDefault
Automatic rate updatesOn: rates are fetched at the set interval and the prices of rate-based products are refreshed with them. Off: no request goes to the service and the last rate or manual rate stays.Off
Refresh ratesFetches rates right now. The time of the last update is written beside it. With the switch off, this button is off too.—
Rate service documentationA guide to the request and response format, for anyone who has their own rate service.—
Custom rate service address (optional)Empty means the Rafina service. If you have your own service, write the full address with https:// and put that service’s key in “Service key”. The key bundled with the theme is never sent to a custom service. Only the site’s main administrator can write it.Empty
Update intervalFrom “Every minute” to “Every 24 hours”. If the service doesn’t answer, it is asked again twice, one second apart, from each of the service’s two separate nodes, and only if all four attempts fail is a failure recorded and the admin notified.Every 15 minutes
Service keyThe theme has its own key and you don’t need to write anything. If you have been issued a dedicated key, put it here; empty means the current key stays. Next to the save button it says where the key comes from (“Key bundled with the theme”).Key bundled with the theme
Rate staleness threshold (minutes)If the last healthy rate is older than this many minutes, it counts as “stale” and “Price updated at …” appears under the product price. A stale rate does not make the product unavailable. Empty means about thirty minutes.Empty
Save rate settingsSaves just these few fields above separately.—

Rates table

Rates are in four tabs: “Coin”, “Gold”, “Metals”, and “Currency”. The table columns:

ColumnWhat it does
NameThe rate name and its English symbol.
Live rateThe latest rate that came from the service.
Manual rate and “Set”If you type a number and click “Set”, it replaces the live rate until you clear it, and the prices of dependent products are built from it immediately. To return to the live rate, clear the field and click Set again.
UnitRate unit (Toman, or dollars for global rates).
Show in headerOnly one rate is shown in the middle of the site header; the one you tick here. “None” means no rate bar in the header.
Top BarTick up to six rates to show them in the Top Bar. These rates take priority over the Top Bar’s own text, and the bar appears with these rates even if it is off in the “Top Bar” section; its color, height, and stickiness still come from that section.

Once at least one rate is ticked for the top bar, a “Rates placement” drawer appears beside the rate names: “In place of the Top Bar text” (the usual behavior) or “Separate bar, beside the Top Bar”. With a separate bar, the Top Bar’s own text and button stay in place and the rates get their own bar with the same color and height; the “Where should the rates bar be” drawer says whether it sits above the Top Bar or below it. If the Top Bar is off, only the rates bar appears.

At the top of the table is the switch “Show header rate on mobile too”: off means the header rate appears only on desktop, not on phones (web app and custom app).

NoteTo tie a product’s price to these rates: product edit page ← “General” tab ← under the price field, the “Pricing basis” drawer and the “Amount” field. For example, basis “Half coin” and amount 1. For a variable product, each variation has its own basis. These fields are visible only when “Automatic rate updates” is on.

Price rounding

Price rounding section with step, rounding direction, and preview
“Price rounding” with a preview on a sample amount.
OptionWhat it does
Round the final price to the nearest1,000, 5,000, or 10,000 Toman. A price built from a rate is rounded to this step.
Rounding direction“Nearest”, “Always up”, or “Always down”.

This is the default for new products, and it can be changed per product on its edit page.

Jeweler's formula

Gold shop profiles table with karat, labor fee, profit, and VAT
Gold shop formula profiles; under each row the price of one gram with that profile is written.

For a product whose basis is gold and which has a profile selected, the price is built like this: gold value + labor fee + profit + VAT. The labor fee is calculated as a percentage of the gold value, and a fixed labor fee is an amount per 750-gram; profit is calculated on gold value plus labor fee, and VAT only on labor fee and profit. A product with no profile has the simple “profit / labor fee”. The theme comes with five ready profiles.

ColumnWhat it does
Profile nameThe name seen in the product page’s “Gold shop profile” drawer.
PurityThis profile’s gold karat.
Has labor fee“No” turns off the two labor fee fields (for example for second-hand gold or bullion).
Labor fee % / fixed labor feeA percentage labor fee, and a fixed labor fee per 750-gram.
Profit % / fixed profitA percentage profit, and a fixed profit per piece.
VAT %Only on labor fee and profit.
Remove / add profileRemoves a profile or creates a new one.

Amounts are in the store’s unit. They are written when you save this page and product prices refresh with the next rate. On a product, under “Pricing basis” there is the “Gold shop profile” drawer and the “Separate setting for this product” button, which takes the labor fee, profit, and karat of that one product separately. On the product page the buyer sees the price breakdown: “Gold value (750 weight: …)”, labor fee, extras, profit, VAT, and if the price was rounded, a “Price rounding” row; the sum of the rows is the price.

Example27.24 grams at karat 748 means 27.167 grams of 750. With a 2% labor fee and 22,222 Toman, labor fee = 2% of gold value + 27.167 × 22,222.

Gold shop mode

For a store where each item has its own labor fee and karat and a shared profile is no use. The “Gold shop mode” box has two fields:

Open gold shop mode row with the switch and the general tax field
“Gold shop mode”.
OptionWhat it doesDefault
This store sells goldTurns on gold shop mode.Off
General tax (%)VAT for products that have “Only this product’s setting”; like the formula, only on labor fee and profit. If tax is written on the product itself, that wins.0

With the mode on:

  • A new product starts with the “Only this product’s setting” profile; existing products are not touched.
  • A “Gold specs” box appears in the “General” tab of the product edit page (described in Edit product).
  • The product page specs and the line under the card price are built from that box’s ticks. Weight, karat, labor fee, profit, and tax are not asked again and come from the same pricing fields.
  • The item’s “Condition” attribute (new, like new, used) is chosen in the same box.
  • The line under the card price writes each attribute as “name: value”, for example “Condition: Like new · Weight: 9.500 g · Karat: 750 · Profit: 3 percent”.
  • Karat is always written in thousandths (for example 750 or 749, not “18”), and weight and 750-weight with three decimal places.

Off means no gold attributes are visible on the site: not the weight and karat rows in the product page specs, nor the line under the card price. A store that doesn’t sell gold never sees these. Gold-formula pricing is untouched and keeps working.

Allowed product pricing bases

List of allowed product pricing bases with a tick for each rate
“Allowed product pricing bases”.

Only the rates ticked here appear in the “Pricing basis” drawer on the product edit page; no ticks means all. For example, a gold store can keep only mithqal and 18-karat gold. Existing products keep their own basis.

FAQ and troubleshooting

Google doesn’t show the product price.

Set “Currency unit in Google schema” to “Rial (IRR)” and wait for Google to crawl again.

Rate-based product prices don’t refresh.

Turn on “Automatic rate updates” and click “Refresh rates” once. If the last update time doesn’t advance, your site has no route to the rate service; an error message appears at the top of this page and in the dashboard. Until it is fixed, set a manual rate.

Gold mithqal differs from other sites’ numbers.

The “Per mithqal” and “Gold mithqal” rates are separate; “Gold mithqal” is built from the 18-karat gram times 4.3318. Set as the basis the same rate your store prices with.