Convert prices
Fetches pre-converted prices from the price sheet for the given destination country, applies tax based on region, and optionally applies custom rounding. Returns final prices in minor units and locale-formatted display strings.
API key authentication for server-side SDK operations. Used for secure server-to-server communication.
In: header
ConvertPricesRequest fetches pre-converted prices from the uploaded price sheet for a given destination country, applies tax, and optionally applies custom rounding.
The destination_amount and pre_rounding_amount in the response use "minor units" (the smallest denomination of a currency as defined by ISO 4217). The decimal_places field tells callers how to interpret amounts: divide by 10^decimal_places to get the human-readable value.
ISO-4217 source currency code (e.g., 'USD'). Currently only 'USD' is supported.
ISO-3166-1 alpha-2 destination country code (e.g., 'DE', 'JP', 'PL'). Used to resolve the destination currency via CLDR.
SKUs (price point identifiers) to look up. Must match the SKU values in the uploaded price sheet.
Optional rounding strategy to apply. Use 'hg' for Huuuge Games charm pricing rounding. Omit for no rounding.
Response Body
curl -X POST "https://test-api.stash.gg/sdk/server/prices/convert" \ -H "Content-Type: application/json" \ -d '{ "sourceCurrency": "string", "destinationCountry": "string", "skus": [ "string" ] }'{
"sourceCurrency": "string",
"destinationCurrency": "string",
"destinationCountry": "string",
"conversions": [
{
"sku": "string",
"sourceAmount": 0,
"destinationAmount": 0,
"preRoundingAmount": 0,
"displayPrice": "string",
"decimalPlaces": 0
}
],
"missingSkus": [
"string"
],
"taxRate": "string",
"taxInclusive": true
}{
"code": 0,
"message": "string",
"details": [
{
"@type": "string",
"property1": null,
"property2": null
}
]
}How is this guide?
Get payment event by ID GET
Retrieves payment details by ID. Returns information about items, pricing, and payment status. This is a server-side endpoint and should not be called from the client.
Get prices GET
Retrieves uploaded pricing sheet data for the shop associated with the API key, filtered by region. Returns paginated price entries.