value

Specifies pricing-related figures associated with the offer. Enables a clear understanding of pricing, taxes and discounts.

countries

Description

Defines the set of countries where specific pricing-related values apply. Enables regional differentiation and accurate presentation.

Guideline

Use the ISO 3166 short name for each country.

Correct Example

"countries": ["United States of America"]

Incorrect Example

"countries": ["USA"]

base_price

Description

Specifies the current selling price of the offer before shipping, modifiers, promotions or taxes if price_including_tax is false. Enables clear communication of current selling price.

Guideline

Currency symbol followed by the amount. If the delivery cost is free, represent it simply as the currency symbol followed by 0.

Correct Example

"base_price": "$150"

Incorrect Example

"base_price": "150 USD"

original_price

Description

Represents the previously listed or recommended price of the offer before shipping, modifiers, promotions or taxes if price_including_tax is false. Allows highlighting price changes.

Guideline

Currency symbol followed by the amount.

Correct Example

"original_price": "$170"

Incorrect Example

"original_price": "Was $170"

import_duties_paid

Description

Specifies whether charges for transporting the offer to the customer's country are included in the base price. Enables clear understanding of total cost to receive the offer.

price_including_tax

Description

Indicates whether applicable government charges are included in the base price. Provides transparency on charges the customer will have to pay.

tax_amount

Description

Details the amount added to the offer due to government charges on the sale. Breaks down government charges for transparency.

Guideline

Currency symbol followed by the amount.

Correct Example

"tax_amount": "$6.50"

Incorrect Example

"tax_amount": "6.50 USD"