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
}