Pricing Configuration

C H A P T E R 12

The default currency in which content is priced is United States dollars. The pricing of content is managed by the Catalog Manager administrator and the Vending Manager administrator. However, to use a currency other than United States dollars, you must change the settings of the currency properties.

Pricing models define how subscribers pay for content, for example, by number of uses or uses in a period of time. Pricing models are managed by the Catalog Manager administrator. However, to add a grace period to content charged on every download, you must define the grace period.

This chapter includes the following topics:

Set the Currency Symbol

Set a Grace Period

12.1 Set the Currency Symbol

The currency used in Content Delivery Server system is defined in the CDS.properties file in the $CDS_HOME/deployment/deployment-name/conf directory. Only one currency is specified per deployment and that currency is used for all components in that deployment. If you deployed multiple Vending Managers, you can specify a different currency for each one as needed.

To specify the currency to use, set the following properties in the CDS.properties file for the deployment.

TABLE 12-1 Currency Properties
Property	Description
`i18n.currency.locale`	Locale code for the currency to use, for example, `fr_CA` for French Canadian.
`i18n.currency.symbol`	Characters used for the monetary symbol, for example, `$` for dollars.
`i18n.currency.code`	Code used for the currency, for example, `CAD` for Canadian dollars.
`i18n.currency.position`	Position of the symbol with respect to the units. Valid values are `before` and `after`.

Note - Changing the currency settings does not convert the amounts already in the system. If a price was entered as $1.50 when the settings were set for United States dollars, the price is £1.50 after the settings are changed to English pounds.

Vending Managers that are deployed separately from the Catalog Manager have an additional set of currency properties in the $CDS_HOME/deployment/deployment-name/conf/VSAdminConsole.properties file. These properties identify the currency used by the Catalog Manager. A Vending Manager that is deployed separately from the Catalog Manager can use a different currency. A Vending Manager that is deployed with the Catalog Manager must use the same currency as the Catalog Manager.

Settings for the following properties in the VSAdminConsole.properties file must match the corresponding settings in the CDS.properties file for the Catalog Manager deployment. Otherwise, incorrect catalog prices are shown in the Vending Manager administration console.

TABLE 12-2 Catalog Manager Currency Properties
Property	Description
`i18n.currency.locale`	Locale code for the currency used by the Catalog Manager, for example, `en_US` for American English.
`i18n.currency.symbol`	Characters used for the monetary symbol, for example, `$` for dollars.
`i18n.currency.code`	Code used for the currency, for example, `USD` for United States dollars.
`i18n.currency.position`	Position of the symbol with respect to the units. Valid values are `before` and `after`.

12.2 Set a Grace Period

A grace period provides subscribers with additional downloads of the same content at no charge. You might want to set a grace period if subscribers are known to have difficulty downloading content on the first try. The grace period can be a set number of downloads, a set number of days during which unlimited downloads are allowed, or a combination of downloads and days. If a combination is used, the grace period ends when one of the two conditions is met. For example, a grace period of five downloads and two days ends when the subscriber downloads the content five times or when two days pass, whichever occurs first.

Grace periods apply only to content associated with the Every Download pricing model. See the Sun Java System Content Delivery Server Reference Manual for information on pricing models. The default values indicate no grace period and subscribers are charged for every download.

To provide a grace period, set the following properties in the $CDS_HOME/deployment/deployment-name/conf/CDS.properties file:

pricing.model.recurringDownload.numberOfDays. Set this property to the number of days that unlimited downloads are allowed per purchase. The default is 0.

pricing.model.recurringDownload.numberOfTimes. Set this property to the number of downloads allowed per purchase.The default is 1.