# Shopper APIs - [Shopper basics](https://docs.digitalriver.com/commerce-api/shopper-apis/shopper-basics.md): Use the Shopper APIs to create a consumer browsing experience. - [Common use cases](https://docs.digitalriver.com/commerce-api/shopper-apis/shopper-basics/common-use-cases.md): Learn more about the common use cases for the Commerce API. - [Creating a customer](https://docs.digitalriver.com/commerce-api/shopper-apis/shopper-basics/common-use-cases/creating-a-customer.md): Learn how to create a customer. - [Applying store credit](https://docs.digitalriver.com/commerce-api/shopper-apis/shopper-basics/common-use-cases/applying-store-credit.md): Learn how to apply store credit. - [Private store workflow](https://docs.digitalriver.com/commerce-api/shopper-apis/shopper-basics/common-use-cases/private-store-workflow.md): Understand the private store workflow. - [Guest checkout](https://docs.digitalriver.com/commerce-api/shopper-apis/shopper-basics/common-use-cases/guest-checkout.md): Understanding guest checkout. - [OAuth](https://docs.digitalriver.com/commerce-api/shopper-apis/oauth.md): Understand Commerce API authentication requests. - [Authentication](https://docs.digitalriver.com/commerce-api/shopper-apis/oauth/authentication.md): Learn how Commerce API authenticates requests. - [OAuth 2.0 APIs](https://docs.digitalriver.com/commerce-api/shopper-apis/oauth/oauth-2.0-apis.md): Understand OAuth 2.0 APIs. - [Token](https://docs.digitalriver.com/commerce-api/shopper-apis/oauth/tokens.md): Learn how to create authenticated shopper tokens. - [Access tokens](https://docs.digitalriver.com/commerce-api/shopper-apis/oauth/access-tokens.md): Learn how to manage access tokens. - [Session-aware access tokens](https://docs.digitalriver.com/commerce-api/shopper-apis/oauth/session-aware-access-tokens.md): Learn how to create session-aware access tokens. - [Authorizing a shopper](https://docs.digitalriver.com/commerce-api/shopper-apis/oauth/authorizing-a-shopper.md): Learn how to authorize a shopper. - [Shoppers](https://docs.digitalriver.com/commerce-api/shopper-apis/shoppers.md): Learn how to manage shoppers. - [Managing shoppers](https://docs.digitalriver.com/commerce-api/shopper-apis/shoppers/managing-shoppers.md): Learn how to manage shoppers. - [User management](https://docs.digitalriver.com/commerce-api/shopper-apis/shoppers/managing-shoppers/user-management.md): Learn how to manage users. - [Single sign-on (SSO)](https://docs.digitalriver.com/commerce-api/shopper-apis/shoppers/managing-shoppers/single-sign-on-sso.md): Understand single sign-on. - [Data validation](https://docs.digitalriver.com/commerce-api/shopper-apis/shoppers/managing-shoppers/data-validation.md): Understand the Data Validation service. - [Bulk user management](https://docs.digitalriver.com/commerce-api/shopper-apis/shoppers/managing-shoppers/bulk-user-management-service.md): Learn how to use the bulk user management service. - [Bulk user account export](https://docs.digitalriver.com/commerce-api/shopper-apis/shoppers/managing-shoppers/bulk-user-account-export-service.md): Learn how to use the Bulk User Account Export service. - [Managing a shopper's account](https://docs.digitalriver.com/commerce-api/shopper-apis/shoppers/managing-a-shoppers-account.md): Learn how to get a shopper's account information. - [Managing a shopper's address](https://docs.digitalriver.com/commerce-api/shopper-apis/shoppers/managing-a-shoppers-address.md): Learn how to manage addresses. - [Managing payment options](https://docs.digitalriver.com/commerce-api/shopper-apis/shoppers/managing-payment-options.md): Learn how to manage payment options. - [Product discovery](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery.md): Learn how to manage products. - [Categories](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/categories.md): Learn how to retrieve categories. - [Products](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/products.md): Learn how to retrieve product information. - [Product variations](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/product-variations.md): Learn how to retrieve product variation information. - [Pricing](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/pricing.md): Learn how to get pricing for a specific product. - [Inventory status](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/inventory-status.md): Learn how to retrieve a product's inventory status. - [Financing](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/financing.md): Learn how to get financing information for a specific product. - [Offers](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/offers.md): Learn how to provide offers. - [Understanding offers](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/offers/offers.md): Understand how to use offers. - [How to use point of promotions (POPs)](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/offers/how-to-use-point-of-promotions-pops.md): Understand how to use POPs. - [Retrieving all point of promotion offers for a specific product](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/offers/how-to-use-point-of-promotions-pops/retrieving-all-point-of-promotion-offers-for-a-specific-product.md): Learn how to retrieve all point of promotion (POP) offers for a specific product. - [Retrieving all offers for a specific point of promotion](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/offers/how-to-use-point-of-promotions-pops/retrieving-all-offers-for-a-specific-point-of-promotion.md): Learn how to get all offers for a specific point of promotion (POP). - [How to use offers](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/offers/how-to-use-offers.md): Learn how to provide offers. - [Private stores](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/private-stores.md): Learn how to use a private store (also known as a purchase plan). - [Managing private stores](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/private-stores/managing-private-stores.md): Lear how to manage private stores. - [Submitting an order for a private store](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/private-stores/submitting-an-order-for-a-private-store.md): Learn how to submit an order for a private store. - [Useful APIs](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/private-stores/useful-apis.md): Learn about the most useful APIs when managing a private store. - [Fulfillment](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/fulfillment-1.md): Learn how to manage fulfillments managed by Digital River. - [Electronic Fulfillment Service (OFI)](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/fulfillment-1/electronic-fulfillment-service-ofi.md): Understand how Electronic Fulfillment Service Integration (OFI) works. - [Digital rights](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/fulfillment-1/digital-rights.md): Understand how Digital Rights work. - [Digital rights revocation](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/fulfillment-1/digital-rights-revocation.md): Understand how the Digital Rights Revocation service works. - [Physical fulfillment](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/fulfillment-1/physical-fulfillment.md): Learn how to integrate the commerce platform with a new fulfillment source. - [EDI X12 832 definition data elements](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/fulfillment-1/physical-fulfillment/edi-x12-832-definition-data-elements.md): Understand the EDI X12 832 definition data elements. - [EDI X12 846 definition data elements](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/fulfillment-1/physical-fulfillment/edi-x12-846-definition-data-elements.md): Understand the EDI X12 846 definition data elements. - [EDI X12 850 definition data elements](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/fulfillment-1/physical-fulfillment/edi-x12-850-definition-data-elements.md): Understand the EDI X12 850 definition data elements. - [EDI X12 855 definition data elements](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/fulfillment-1/physical-fulfillment/edi-x12-855-definition-data-elements.md): Understand the EDI X12 855 definition data elements. - [EDI X12 856 definition data elements](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/fulfillment-1/physical-fulfillment/edi-x12-856-definition-data-elements.md): Understand the EDI X12 856 definition data elements. - [EDI X12 180-1 definition data elements](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/fulfillment-1/physical-fulfillment/edi-x12-180-1-definition-data-elements.md): Understand the EDI X12 180-1 definition data elements. - [EDI X12 180-2 definition of data elements](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/fulfillment-1/physical-fulfillment/edi-x12-180-2-definition-of-data-elements.md): Understand the EDI X12 180-2 definition of data elements. - [EDI X12 180-3 definition of data elements](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/fulfillment-1/physical-fulfillment/edi-x12-180-3-definition-of-data-elements.md): Understand the EDI X12 180-3 definition of data elements. - [Cart](https://docs.digitalriver.com/commerce-api/shopper-apis/cart.md): Learn how to create and manage a cart. - [Applying a shopper to a cart](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/applying-a-shopper-to-a-cart.md): Learn how to apply a shopper to a cart. - [Getting the current cart](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/getting-the-current-cart.md): Learn how to get the active current cart for a specified token. - [Creating or updating a cart](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/creating-or-updating-a-cart.md): Learn how to create or update a cart. - [Adding a product to a cart](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/creating-or-updating-a-cart/adding-a-product-to-a-cart.md): Learn how to add a product to a cart. - [Gifting](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/creating-or-updating-a-cart/adding-a-product-to-a-cart/gifting.md): Learn how to mark a product as a gift and send it to a recipient programmatically. - [Capturing the customer's IP address](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/creating-or-updating-a-cart/shopper-ip-address.md): You can capture the IP address of the customer who placed the order. Digital River uses this IP address to identify and prevent fraudulent activities. - [Providing address information](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/creating-or-updating-a-cart/providing-address-information.md): Learn how to provide ship from and ship to information for products in your cart. - [Managing the shipping or billing address](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/creating-or-updating-a-cart/managing-the-shipping-or-billing-address.md): Learn how to manage the shipping or billing address. - [Providing subscription information](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/creating-or-updating-a-cart/providing-subscription-information.md): Learn how to provide the customer's subscription information that Digital River needs to process recurring payments. - [Managing payment methods](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/creating-or-updating-a-cart/managing-payment-methods.md): Learn how to manage payment methods in a cart. - [Capturing the Terms of Sale (TOS) acceptance](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/creating-or-updating-a-cart/terms-of-sale-acceptance.md): Learn how to add a TOS acceptance. - [Managing offers in a cart](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-offers-in-a-cart.md): Learn how to manage offers in a cart. - [Applying an offer](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-offers-in-a-cart/applying-an-offer.md): Learn how to apply an offer. - [Applying a coupon or promo code](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-offers-in-a-cart/applying-a-coupon-code.md): Learn how to apply a coupon or promo code. - [Getting all applied offers](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-offers-in-a-cart/getting-all-applied-offers.md): Learn how to retrieve all offers applied to the cart. - [Removing an applied offer](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-offers-in-a-cart/removing-an-applied-offer.md): Learn how to remove an offer applied to the cart. - [Removing eligible offers](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-offers-in-a-cart/removing-eligible-offers.md): Learn how to remove eligible offers from a customer's cart - [Reconciling conflicting offers](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-offers-in-a-cart/reconciling-conflicting-offers.md): Learn how Digital River reconciles conflicting offers. - [Dynamic offers/personalization](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-offers-in-a-cart/dynamic-offers-personalization.md): Understand the dynamic offer and personalization capabilities. - [Skipping Global Commerce merchandising offer arbitration](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-offers-in-a-cart/dynamic-offers-personalization/skipping-global-commerce-merchandising-offer-arbitration.md): Learn how to bypass offer arbitration. - [Triggering a promotional URL offer](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-offers-in-a-cart/dynamic-offers-personalization/triggering-a-promotional-url-offer.md): Learn how to trigger a promotional URL offer. - [Overriding a promotional URL offer discount](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-offers-in-a-cart/dynamic-offers-personalization/overriding-a-promotional-url-offer-discount.md): Learn how to override a promotional URL offer discount. - [Pricing](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/pricing.md): Understand how pricing works. - [Landed cost](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/pricing/landed-costs.md): Understand how landed cost works and how to apply them to orders. - [Mixed cart support](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/pricing/landed-costs/mixed-cart-support.md): Understand how landed costs supports a mixed cart. - [Tax-included pretty price](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/pricing/landed-costs/tax-included-pretty-price.md): Learn how to apply landed cost with tax-included pretty price. - [Redirecting to a Digital River-hosted cart](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/redirecting-to-a-digital-river-hosted-cart.md): Learn how to redirect to a Digital River-hosted cart. - [Configuring taxes](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/configuring-taxes.md): Learn how to properly configure taxes on items and shipping in Global Commerce. - [Managing tax identifiers](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/configuring-taxes/managing-tax-identifiers.md): Learn how to manage tax identifiers. - [Managing shipping options](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-shipping-options.md): Learn how to manage shipping options. - [Getting shipping options](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-shipping-options/getting-shipping-options.md): Lear how to get shipping options. - [Providing a shipping discount](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-shipping-options/providing-a-shipping-discount.md): Learn how to provide a shipping discount. - [Managing line items](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-line-items.md): Learn how to manage line items. - [Applying a price override](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/applying-a-price-override.md): Learn how to apply a price override to a cart. - [Managing payment sessions](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/payment-sessions.md): Learn the basics of payment sessions and how to migrate your integration. - [Managing web checkout](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-web-checkout.md): Learn how to manage a web checkout. - [Submitting a cart](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/submitting-a-cart.md): Learn how to submit a cart. - [Initiating a charge](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/submitting-a-cart/initiating-a-charge.md): Learn how to specify the type of charge. - [Authorization declines](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/submitting-a-cart/authorization-declines.md): Learn about the different types of authorization declines and how to handle them. - [Resuming cart submission](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/resuming-cart-submission.md): Learn how to resume cart submission after completing a redirect payment method. - [HGOP2](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/hgop2.md) - [Orders](https://docs.digitalriver.com/commerce-api/shopper-apis/orders-1.md): Learn how to process orders. - [Getting orders](https://docs.digitalriver.com/commerce-api/shopper-apis/orders-1/getting-orders.md): Learn how to retrieve orders. - [Selling entities](https://docs.digitalriver.com/commerce-api/shopper-apis/orders-1/selling-entities.md): Learn how Digital River dynamically assigns selling entities. - [Retrieving addresses from an order](https://docs.digitalriver.com/commerce-api/shopper-apis/orders-1/retrieving-addresses-from-an-order.md): Learn how to retrieve a billing or shipping address from an order. - [Retrieving line items from an order](https://docs.digitalriver.com/commerce-api/shopper-apis/orders-1/retrieving-line-items-from-an-order.md): Learn how to retrieve line items from an order. - [Order lookup](https://docs.digitalriver.com/commerce-api/shopper-apis/orders-1/order-lookup.md): Learn how to lookup orders. - [Returns](https://docs.digitalriver.com/commerce-api/shopper-apis/orders-1/returns.md): Understand how returns work. You can use Commerce API to process customer returns for one or more items in an order. - [Initiate an authenticated session](https://docs.digitalriver.com/commerce-api/shopper-apis/orders-1/returns/initiate-an-authenticated-session.md): Learn how to initiate an authenticated session for a return. - [Setting up returns in Global Commerce](https://docs.digitalriver.com/commerce-api/shopper-apis/orders-1/returns/setting-up-returns-in-global-commerce.md): Learn how to set up returns in Global Commerce. - [Managing returns](https://docs.digitalriver.com/commerce-api/shopper-apis/orders-1/returns/retrieving-returns-for-a-specified-order.md): Learn how to manage returns for a specified order. - [Subscriptions](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions.md): Learn how to manage subscriptions from the Shoppers APIs. - [Retrieve the subscription](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/retrieve-the-subscription.md): Learn how to retrieve subscriptions from the Shopper APIs. - [Getting all orders for a subscription](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/retrieve-the-subscription/getting-all-orders-for-a-subscription.md): Learn how to get all orders linked to a specific subscription. - [Getting a subscription's pending actions](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/retrieve-the-subscription/getting-a-subscriptions-pending-actions.md): Learn how to get a subscription's pending actions. - [Getting all subscriptions for a shopper](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/retrieve-the-subscription/getting-a-shoppers-subscription.md): Learn how to get al subscriptions for a shopper. - [Getting a subscription by identifier](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/retrieve-the-subscription/getting-a-subscription-by-identifier.md): Learn how to get a subscription by using the subscription identifier. - [Update subscription at the next renewal](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/update-subscription-at-the-next-renewal.md): Learn how to apply changes to a subscription for the next renewal. - [Changing the subscription renewal type](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/update-subscription-at-the-next-renewal/changing-the-subscription-renewal-type.md): Learn how to change the subscription renewal type. - [Changing the subscription renewal quantity](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/update-subscription-at-the-next-renewal/changing-the-subscription-renewal-quantity.md): Learn how to change the quantity of the renewed subscription. - [Adding or updating a perpetual unit price](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/update-subscription-at-the-next-renewal/adding-or-updating-a-perpetual-unit-price.md): Learn how to assign a perpetual unit price to a subscription with add-ons. - [Changing the subscription's payment option](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/update-subscription-at-the-next-renewal/changing-the-subscriptions-payment-option.md): Learn how to change the subscription's payment option. - [Changing the subscription's payment source](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/update-subscription-at-the-next-renewal/changing-the-subscriptions-payment-source.md): Learn how to change the subscription's payment source. - [Immediately change the subscription](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/immediately-change-the-subscription.md): Learn how to apply a change to a subscription immediately. - [Updating the subscription's shipping address](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/immediately-change-the-subscription/updating-the-subscriptions-shipping-address.md): Learn how to change the subscription's shipping address. - [Updating a subscription's billing and shipping email address](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/immediately-change-the-subscription/updating-a-subscriptions-billing-and-shipping-email-address.md): Learn how to update a subscription's billing and shipping email address. - [Cancelling a subscription](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/immediately-change-the-subscription/cancelling-a-subscription.md): Learn how to cancel a subscription by the subscription identifiers. - [Immediately apply a midterm subscription change](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/immediately-apply-a-midterm-subscription-change.md): Learn which Subscription APIs apply an immediate mid-term change. - [Reducing the subscription renewal quantity](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/immediately-apply-a-midterm-subscription-change/reducing-the-subscription-renewal-quantity.md): Learn how to reduce the subscription renewal quantity. --- # 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/shopper-apis.md?ask= ``` 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.