GetMerchantPriceDetails
Obtain the parameters required to calculate international product prices in a destination country’s currency.
Query Parameters
Secret token (unique merchant ID) to be provided to the merchant by Global‑e.
2-char ISO destination country code. Example: IL
3-char ISO currency code of the customer's country (destination country). Example: ILS
Response
The set of price calculation parameters and rules for the requested destination country and currency.
The price calculation parameters and rules returned for a destination country and currency. Field names, types, and descriptions are taken verbatim from the docs "Parameters" (Response) table; currencyFormatSymbol and isGrossPrices appear only in the worked example (no table row) and are flagged in review §2.
2-char ISO destination country code. Example: IL
3-char ISO destination country code. Example: ISR
The name of the destination country. Example: Israel
The symbol of the currency in the destination country. Example: ₪
3-char ISO currency code of the customer's country (destination country). Example: ILS
Currency formatting flags. Inferred entirely from the worked example (no property table on the page); types inferred from the example values. See review §2.
Currency decimal separator type. ("," or ".") Example: XX.XX XX,XX
Currency thousands separator indicator. ("," or ".") Example: XXX.XXX XXX,XXX
Currency decimal places. Example: 0
The language or locale of the destination country. Example: he
Merchant's base country code 2-char ISO. Example: GB
The symbol of the currency in the country or origin (merchant's country or base country). Example: £
The currency code in the merchant's base country.
Currency decimal places in the base currency. Example: 2
Whether the selected country is operated by Global-e. This flag is be used as a Mode indicator. True: yes. In this case, Global-e converts the prices and opens their checkout. False: no. Countries that are not operated by Global‑e must still be available for selection as a shipping destination on the merchant's site. However Global‑e functionality must be disabled for such countries.
Conversion rate between the base currency (GBP in this example) and the converted currency (ILS in this example). Example: 284.001848944500
Price uplift as set for this destination country. Example: 1.050000
Product uplift as set per product (if the product uplift is set, this parameter overrides the country uplift), TYPE = object of key or value pairs (string / decimal). Example: {"extra-charge": 1.05, "special": 1.1}
Present only in the worked example (no Parameters-table row); type inferred from the example value.
List of rounding rules that are applied when converting the prices, based on the rounding rule ranges and business rules.
VAT settings and calculation. Only applicable to European countries. Properties verbatim from the "VAT Settings" > VAT Options property table.

