Order prices

Below is part of an example response from the /orders/{orderUuid} endpoint, complete with various price properties:

Copy

Copied

{
	[...]
	"items": [
		{
			[...]
			"product": {
				[...]
				"original_retail_price": {
					"currency": "USD",
					"value": 12.0,
					"formatted_value": "$ 12.00",
					"formatted_iso_value": "$12.00"
				},
				"original_retail_price_without_service_fee": {
					"currency": "USD",
					"value": 10.0,
					"formatted_value": "$ 10.00",
					"formatted_iso_value": "$10.00"
				},
				"retail_price": {
					"currency": "USD",
					"value": 10.8,
					"formatted_value": "$ 10.80",
					"formatted_iso_value": "$10.80"
				},
				"retail_price_without_service_fee": {
					"currency": "USD",
					"value": 8.8,
					"formatted_value": "$ 8.80",
					"formatted_iso_value": "$8.80"
				},
				"discount_amount": {
					"currency": "USD",
					"value": 1.2,
					"formatted_value": "$ 1.20",
					"formatted_iso_value": "$1.20"
				},
				"service_fee": {
					"currency": "USD",
					"value": 2.0,
					"formatted_value": "$ 2.00",
					"formatted_iso_value": "$2.00"
				}
			},
			"quantity": 2,
			"retail_price_in_order_currency": {
				"currency": "USD",
				"value": 10.8,
				"formatted_value": "$ 10.80",
				"formatted_iso_value": "$10.80"
			},
			"total_retail_price_in_order_currency": {
				"currency": "USD",
				"value": 21.6,
				"formatted_value": "$ 21.60",
				"formatted_iso_value": "$21.60"
			},
			[...]
		}
	],
	"total_price": {
		"currency": "USD",
		"value": 16.85,
		"formatted_value": "$ 16.85",
		"formatted_iso_value": "$16.85"
	},
	"discount_amount": {
		"currency": "USD",
		"value": 7.15,
		"formatted_value": "$ 7.15",
		"formatted_iso_value": "$7.15"
	},
	[...]
}

Order item prices

Every item in an order corresponds to a cart item from the cart used to create the order.

For the most part, the price properties for each order item correspond to the cart item properties. For more information, refer to the cart prices page.

However, an order item contains additional properties:

retail_price_in_order_currency
- The retail_price of a single item's product, regardless of the quantity.
total_retail_price_in_order_currency
- retail_price_in_order_currency * quantity

If an order has not been paid yet, the currency for these two properties will match the original currency of the product. After payment, the currency will match the one used for payment.

Order prices

In addition to the order items, an order contains its own price properties:

discount_amount
- The total discount for the order, the sum of every order item's total_discount .
total_price
- The total price customers are expected to pay, the sum of every order item's retail_price .