Pretty pricing
Learn how to apply landed cost with pretty pricing.
Pretty pricing is a feature that allows you to display a price that appeals to your shoppers. This guide shows you how to enable and use landed cost with pretty pricing.
See Best practice flows by payment type for more information.
Prerequisites
To enable pretty pricing, you need to:
Work with your Customer Success Manager to enable landed cost.
Work with your Customer Success Manager to enable landed cost pretty price.
Create a price list and enable Prices Include Value Added Tax (VAT).
Creating a price list with pretty pricing
Price lists allow you to define how to convert product prices from the default currency to other currencies for different locales. Create a price list with Prices Include Value Added Tax (VAT) enabled to enable pretty pricing.
Sign in to Global Commerce.
If your company has more than one site, select the site from the Sites field. Global Commerce automatically populates the Site field if your company has only one site.
Select Catalog, select Pricing & Plans, and then choose one of the following options:
Click Create Price List.
Click Manage Price Lists and then click Create Price List.
The Create Price List page appears.
Complete the fields, and select the Prices Include Value Added Tax (VAT) checkbox to enable tax-inclusive pricing. See Create Price List attributes for more information.
Click Save. The Price List Details page appears.
Complete the fields on the Price List Details page. See the Price List Details attributes for more information.
Scroll down and click Done.
Setting the shipping cost to tax exclusive
The Features tab on the Configure Site Settings page allows you to enable or disable features that appear in your store. For landed cost and landed cost pretty pricing, shipping costs should be tax exclusive.
From Global Commerce, select Administration, select Site, then click Configure Site Settings. The Configure Site Settings page appears.
To set the shipping cost to tax exclusive, click the Features tab, scroll down to Input Tax-Inclusive Shipping Cost, and set the toggle for Input Tax-Inclusive Shipping to OFF. Digital River will send the tax-exclusive shipping costs to the shipping carrier for the landed cost calculation. This ensures the shopper is not double-taxed by the shipping carrier. Note: If you need to support shipping a product to another locale within a country (non-cross border), and the locale supports the landed cost solution, contact your Customer Success Manager.
Click Apply.
Landed cost without pretty pricing
When pretty pricing is disabled, the landed cost solution can only accept the Tax Exclusive Product Price. You need to manually calculate a tax-exclusive price, and then add the tax-exclusive price to the price list. If the tax-inclusive price is $1599, you can back-calculate the product price to $1279.2 without taxes. If a locale does not accept decimals, Digital River rounds the price to $1279.
Product pricing setup:
Physical product price (tax exclusive): $1279
Shipping cost (tax exclusive): $0 (free shipping)
Estimated tax rate configured by Digital River: 25%
In the following table, you can see the final price (orderTotal
) is $1598.75. While its not a pretty price, it's close to the expected $1599.
Physical line item
listPrice: 1279
salePrice: 1279
productTax: 319.75
shippingTax: 0
feeTax: 0
taxRate: 0.25
importTax: 0
importDuty: 0
listPrice: 1279
salePrice: 1279
productTax: 0
shippingTax: 0
feeTax: 0
taxRate: 0
importTax: 319.75
importDuty: 0
Order level
subtotal: 1598.75
discount: 0
shippingAndHandling: 0
importTaxAndDuty: 0
tax: 319.75
orderTotal: 1598.75
subtotal: 1598.75
discount: 0
shippingAndHandling: 119
importTaxAndDuty: 319.75
tax: 0
orderTotal: 1598.75
Tax inclusive flag
taxinclusive: false
taxInclusive: false
Landed cost with pretty pricing
Product pricing setup:
Physical product price (tax inclusive): $1599
Shipping cost (tax exclusive): $0 (free shipping)
Estimated tax rate configured by Digital River: 25%
In the following table, you can see the pretty pricing in the final price where the orderTotal
is $1599.
Physical line item
listPrice: 1599
salePrice: 1599
productTax: 319.8
shippingTax: 0
feeTax: 0
taxRate: 0.25
importTax: 0
importDuty: 0
listPrice: 1599
salePrice: 1599
productTax: 0
shippingTax: 0
feeTax: 0
taxRate: 0
importTax: 319.8
importDuty: 0
Order level
subtotal: 1599
discount: 0
shippingAndHandling: 0
importTaxAndDuty: 0
tax: 319.8
orderTotal: 1599
subtotal: 1599
discount: 0
shippingAndHandling: 119
importTaxAndDuty: 319.8
tax: 0
orderTotal: 1599
Tax inclusive flag
taxInclusive: true
taxInclusive: true
See Pricing fields for more information.
Pretty pricing in the shopper's checkout flow
Cart
The callouts in the following list show the API response payloads that correspond with the pretty pricing values that appear on the Cart page.

The total calculated price for the line item with quantity (
listPriceWithQuantity
). You can find it here in the response:"lineItems": { ... "lineItem": {
"pricing": { ... "listPriceWithQuantity": { "currency": "USD", "value": 3016.00 ... }, ... } ... } ... }
The total calculated price for the line item with quantity (
salePriceWithQuantity
). You can find it here in the response:"lineItems": { ... "lineItem": {
"pricing": { ... "salePriceWithQuantity": { "currency": "USD", "value": 2413.00 ... }, ... } ... } ... }
The shipping and handling fee of the order (
shippindAndHandling
). You can find it here in the response:"pricing": { ... "shippingAndHandling": { "currency": "USD", "value": 171.00 }, ... }
The final price of the order (
orderTotal
). You can find it here in the response:"pricing": { ... "orderTotal": { "currency": "USD", "value": 2513.00 }, ... }
See Pricing fields for more information.
Order review
The callouts in the following list show the API response payloads that correspond with the pretty pricing values that appear on the Order Review page.

The final price of the order (
orderTotal
). You can find it here in the response:pricing
>orderTotal "pricing": { ... "orderTotal": { "currency": "USD", "value": 2684.00 }, ... }
The import taxes and duties of the order, which is the sum of import taxes and duties for all the line items (
importTaxAndDuty
). Make sure the value forlandedCostState
isPREPAID
. You can find it here in the response:pricing
>orderTotal "pricing": { ... "importTaxAndDuty": { "currency": "USD", "value": 152.00 }, ... }
See Pricing fields for more information.
Thank you
The callouts in the following list show the API response payloads that correspond with the pretty pricing values that appear on the Thank You page.

The final price of the order (
orderTotal
). You can find it here in the response:"pricing": { ... "orderTotal": { "currency": "USD", "value": 2684.00 }, ... }
See Pricing fields for more information.
Invoice
The callouts in the following list show the API response payloads that correspond with the pretty pricing values that appear on the Invoice.

The total calculated price for the line item with quantity (
salePriceWithQuantity
). You can find it here in the response:"lineItems": { ... "lineItem": {
"pricing": { ... "salePriceWithQuantity": { "currency": "USD", "value": 2413.00 ... }, ... } ... } ... }
The shipping and handling fee (
shippindAndHandling
). You can find it here in the response:"pricing": { ... "shippingAndHandling": { "currency": "USD", "value": 171.00 }, ... }
The final price of the order (
orderTotal
). You can find it here in the response:"pricing": { ... "orderTotal": { "currency": "USD", "value": 2513.00 }, ... }
The order-level import taxes and duty (
importTaxAndDuty
) is the sum of all line items' import taxes (importTax
) and import duties (importDuty
). For example:importDutyTax
: 75lineItem
: AimportTax
: 15importDuty
: 10
lineItem
: BimportTax
: 30importDuty
: 20
Make sure the value for
landedCostState
isPREPAID
. You can find it here in the response:"pricing": { ... "importTaxAndDuty": { "currency": "USD", "value": 75.00 }, ... "importTax": { "currency": "USD", "value": 15.00 }, ... "importDuty": { "currency": "USD", "value": 10.00 }, ... "importTax": { "currency": "USD", "value": 30.00 }, ... "importDuty": { "currency": "USD", "value": 20.00 }, ... }
See Pricing fields for more information.
Additional pricing information
The callouts in the following list show the API response payloads that correspond with the pretty pricing values that appear on the Invoice as additional pricing information.

The total calculated price for the line item with quantity (
salePriceWithQuantity
). You can find it here in the response:"lineItems": { ... "lineItem": {
"pricing": { ... "salePriceWithQuantity": { "currency": "USD", "value": 2261.00 ... }, ... } ... } ... }
The tax amount for the product (
productTax
) at the line-item level with quantity. You can find it here in the response:"lineItems": { ... "lineItem": { ... "id="488822300023", ...
"pricing": { ... "productTax": { "currency": "USD", "value": 0.00 ... }, ... } ... } "lineItem": { ... "id="488822300024", ...
"pricing": { ... "productTax": { "currency": "USD", "value": 5.00 ... }, ... } ... } ... }
The sum of the import tax (
importTax
) and import duty (importDuty
). (Make sure the value forlandedCostState
isPREPAID
.) You can find it here in the response:"lineItems": { ... "lineItem": { ... "id="488822300023", ...
"pricing": { ... "importTax": { "currency": "USD", "value": 103.00 }, ... "importDuty": { "currency": "USD", "value": 49.00 }, ... } "lineItem": { ... "id="488822300024", ...
"pricing": { ... "importTax": { "currency": "USD", "value": 0.00 }, ... "importDuty": { "currency": "USD", "value": 0.00 }, ... } ... }
The sale price with quantity (
salePriceWithQuantity
) excluding the import tax (importTax
) and import duty (importDuty
)."lineItems": { ... "lineItem": { ... "id="488822300023", ...
"pricing": { ... "salePriceWithQuantity": { "currency": "USD", "value": 2413.00 }, ... } "lineItem": { ... "id="488822300024", ...
"pricing": { ... "salePriceWithQuantity": { "currency": "USD", "value": 100.00 }, ... } ... }
The shipping and handling fee (
shippindAndHandling
). You can find it here in the response:"pricing": { ... "shippingAndHandling": { "currency": "USD", "value": 171.00 }, ... }
The sum of import taxes and duties for all the line items (
importTaxAndDuty
). Make sure the value forlandedCostState
isPREPAID
. You can find it here in the response:"pricing": { ... "importTaxAndDuty": { "currency": "USD", "value": 152.00 }, ... }
The sum of all taxes (
tax
) for the order. You can find it here in the response:"pricing": { ... "tax": { "currency": "USD", "value": 5.00 }, ... }
The final price of the order (
orderTotal
). You can find it here in the response:"pricing": { ... "orderTotal": { "currency": "USD", "value": 2684.00 }, ... }
See Pricing fields for more information.
Last updated
Was this helpful?