External Methods
GetMerchantPriceDetails REST API
This API enables merchants to obtain the parameters required to calculate international product prices in a destination country's currency.
Method/URL:
GET https://[GEM_API_URL]/externalapi/GetMerchantPriceDetails?merchantToken=[Merchant id]&Country=[CountryCode]&Currency=[CurrencyCode]
Request query type: string
Parameters:
GEM_API_URL | The API host name, based on the environment (such as sandbox, live, and more). |
MerchantToken | Secret token (unique merchant ID) to be provided to the merchant by Global‑e. |
Country | 2-char ISO destination country code. Example: IL |
Currency | 3-char ISO currency code of the customer's country (destination country). Example: ILS |
Response
{ "countryCode": "IL", "countryCode3": "ISR", "countryName": "Israel", "currencySymbol": "₪", "currencyCode": "ILS", "currencyFormatSymbol": { "PlaceCurrencySymbolBeforePrice": true, "UseCurrencySymbolSpace": false }, "currencyDecimalNominator": ".", "currencyThousandSeparator": ",", "currencyDecimalPlaces": 0, "culture": "he", "baseCountryCode": "GB", "baseCurrencySymbol": "£", "baseCurrencyCode": "GBP", "baseCurrencyDecimalPlaces": 2, "isOperatedByGlobale": true, "currencyConversionRate": 284.001848944500, "countryCoefficientRate": 1.050000, "productClassCoefficients": { "extra-charge": 1.800000 }, "isGrossPrices": true, "roundingRules": { "RoundingRuleId": 108, "CurrencyCode": "ILS", "CountryCode": null, "RoundingRanges": [{ "From": 1.0000, "To": 100.0000, "Threshold": 0.0100, "LowerTarget": 1.0000, "UpperTarget": 1.0000, "RangeBehavior": 3, "TargetBehaviorHelperValue": 1.0000, "RoundingExceptions": [] }, { "From": 100.0000, "To": 1000.0000, "Threshold": 5.0100, "LowerTarget": 15.0000, "UpperTarget": 10.0000, "RangeBehavior": 3, "TargetBehaviorHelperValue": 10.0000, "RoundingExceptions": [] }, { "From": 1000.0000, "To": 10000.0000, "Threshold": 50.0100, "LowerTarget": 150.0000, "UpperTarget": 100.0000, "RangeBehavior": 3, "TargetBehaviorHelperValue": 100.0000, "RoundingExceptions": [] }, { "From": 10000.0000, "To": 100000000000000.0000, "Threshold": 0.0100, "LowerTarget": 100.0000, "UpperTarget": 100.0000, "RangeBehavior": 3, "TargetBehaviorHelperValue": 100.0000, "RoundingExceptions": [] }] }, "vatSettings": { "VATTypeId": 0, "LocalVATRate": 20.000000, "DistanceSellingVATRate": 20.000000, "UseDistanceSellingVAT": false } } });
GetCountries
Returns a list of countries with their properties.
Method/URL
GET https://[DOMAIN_URL]/externalapi/GetCountries?merchantToken={MerchantToken}
Example
Response
{ "countryCode": "US", "countryCodeISO3": "USA", "countryName": "United States", "isOperatedByGlobale": true, "defaultCurrencyCode": "USD", "isFixedPricesSupported": true }
GetCurrencies
Returns a list of currencies with their properties.
Method/URL
GET https://[DOMAIN_URL]/externalapi/GetCurrencies?merchantToken={MerchantToken}
Example
Response
{ "currencyCode": "USD", "currencyName": "US Dollar", "currencySymbol": "$", "decimalPlaces": 2 }