# Merchandising

## Point of promotions (POPs)

Offers use a POP to display the offer. A POP determines where an offer appears in an online store. A POP can be an interstitial page, banner or homepage image, pop-up window, etc. You can configure the offer's POP when you configure the offer in Global Commerce. Offers retrieved for a cart using the [Offers ](https://www.digitalriver.com/docs/commerce-api-reference/#tag/Offers)resource must be POP-driven. Providing a POP when getting offers for a shopper or products is now optional. The system automatically applies the following offers to a cart:

* Certain offers without POPs, such as shipping offers
* Discounts
* Bundles.
* Buy M, Get N

<div align="left"><figure><img src="/files/dpIcSa3jtJcG86dyRCSg" alt=""><figcaption></figcaption></figure></div>

{% tabs %}
{% tab title="URI" %}
{% code overflow="wrap" %}

```http
GET /shoppers/me/point-of-promotions/Home_topSeller/offers
```

{% endcode %}
{% endtab %}

{% tab title="Request header" %}
{% code overflow="wrap" %}

```http
Host: api.digitalriver.com
User-Agent: API Client/1.0
Accept: */*
Authorization: bearer your_access_token
```

{% endcode %}
{% endtab %}

{% tab title="Payload" %}

```
The request body should be empty.
```

{% endtab %}

{% tab title="200 OK response" %}
{% code overflow="wrap" %}

```json
{
	"offers": {
		"offer": [
			{
				"name": "Home_topSeller_1",
				"productOffers": {
					"_uri": "https://api.digitalriver.com/v1/shoppers/me/point-of-promotions/Home_topSeller/offers/offer_ID/product-offers"
				},
				"_uri": "https://api.digitalriver.com/v1/shoppers/me/point-of-promotions/Home_topSeller/offers/offer_ID"
			},
			{
				"name": "Home_topSeller_2",
				"productOffers": {
					"_uri": "https://api.digitalriver.com/v1/shoppers/me/point-of-promotions/Home_topSeller/offers/offer_ID/product-offers"
				},
				"_uri": "https://api.digitalriver.com/v1/shoppers/me/point-of-promotions/Home_topSeller/offers/offer_ID"
			},
			{
				"name": "Home_topSeller_3",
				"productOffers": {
					"_uri": "https://api.digitalriver.com/v1/shoppers/me/point-of-promotions/Home_topSeller/offers/offer_ID/product-offers"
				},
				"_uri": "https://api.digitalriver.com/v1/shoppers/me/point-of-promotions/Home_topSeller/offers/offer_ID"
			},
			{
				"name": "Home_topSeller_4",
				"productOffers": {
					"_uri": "https://api.digitalriver.com/v1/shoppers/me/point-of-promotions/Home_topSeller/offers/offer_ID/product-offers"
				},
				"_uri": "https://api.digitalriver.com/v1/shoppers/me/point-of-promotions/Home_topSeller/offers/offer_ID"
			}
		],
		"_uri": "https://api.digitalriver.com/v1/shoppers/me/point-of-promotions/Home_topSeller/offers"
	}
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

You do not need to send additional API calls to get these offers when a shopper adds products to a cart.

The Offers resource returns the configured attributes for an offer. The product offer contains offer-specific information on the product, including the offer-specific price of the product. You can apply both the Offers resource and&#x20;

To retrieve all available offers for a shopper, product, or cart resource respectively, use the following resources:

* G`ET shoppers/me/point-of-promotions/{popName}/offers`
* `GET shoppers/me/products/{productId}/point-of-promotions/{popName}/offers`
* `GET shoppers/me/carts/active/point-of-promotions/{popName}/offers`&#x20;

The `popName` and ID originate in Digital River.

The system applies offers to a cart—it does not apply offers to a shopper. The API applies offers to the line items within a cart. Coupon code limits may apply to a shopper if you configure a coupon code offer in Digital River to limit the code to one per shopper.

When you configure multiple offers for a product, the offer that provides the greatest discount (the lowest price) for an order takes precedence. Also, a line item can have an order discount applied with a product discount. For more information on configuring offers and offer precedence, refer to the online help in Global Commerce.

Global Commerce automatically applies shipping offers to products added to a cart when they meet the offer criteria and do not require API calls. It also automatically applies discounts, bundles, and "buy x, get y" offers.

## Private stores

You can use [Global Commerce](https://gc.digitalriver.com/gc/ent/home.do) to create a private store. The site owner, who has a Private Store Manager role in the Global Commerce user interface (UI), configures private stores at the site level. Private stores allow sites to target segmented shoppers, called target markets. Sites can deploy, rotate, and retire private stores to suit current product marketing trends.

{% hint style="info" %}
**Note**: In the Global Commerce UI, private stores used to be called purchase plans, and the APIs reflect the former nomenclature in version 1 (v1)
{% endhint %}

For information on submitting an order for a private store, see [Private Store](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/private-stores).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digitalriver.com/commerce-api-references/commerce-api-reference-guide/admin-apis-reference/merchandising.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.