As the authorized reseller of your products and services, Digital River sells through multiple local entities. These selling entities allow us to support localized payment processing, payment methods, and fulfillment.

The selling entity determines your eligible payment methods and payment processors. It also determines the tax applied to the order and any tax identifiers or certificates that should be collected from the customer.

As shown in the following example, Digital River dynamically assigns a sellingEntity that is returned in Checkout and Order responses.

{
    ...
    "sellingEntity": {
        "id": "DR_IRELAND-ENTITY",
        "name": "Digital River Ireland Ltd."
    },
    ...
}

We also assign a buying entity that purchases products from you. This entity does not affect the order, but does determine which Digital River entity makes a payout to you.

How selling entities are assigned

When you create or update a Checkout, Digital River assigns and returns a sellingEntity . The entity we assign is based on the ship from and ship to addresses for physical products and billing addresses for digital products.

When assigning a selling entity, we also look at your eligible entities, which are determined by your trading patterns and contract with Digital River.

For physical products, Digital River, Inc. handles fulfillments shipped from the United States and Digital River Ireland Ltd. handles fulfillments shipped from most countries in the European Union.

The default selling entities for digital products purchased in the United States and digital products purchased in the rest of the world are Digital River, Inc and Digital River Ireland Ltd., respectively.

As part of your contract with Digital River, and depending on your specific needs, we can also enable and configure other eligible entities.

Physical products

The following table explains in more detail how Digital River determines the selling and buying entities for physical products. The Ship From and Ship To columns contain a two-letter country code. We support a limited number of Ship From countries and there is no default value.

For each Ship From country in the table, you can ship products to any country in the Ship To column of the associated record.

The asterisk (*) represents a wildcard. When assigning a selling and buying entity, Digital River first attempts to make an exact match. If we cannot find an exact match, then we use the wildcards to assign the appropriate entity.

For example, let's say you're shipping a product from the United States to Mexico. Your contract specifies DRGT as an eligible entity. Since no exact match exists, the Ship To wildcard is used to assign DR globalTech, Inc. as the selling and buying entity. If DRGT were not one of your specified eligible entities, then we would assign the order to Digital River, Inc.

Digital products

The following table shows how Digital River determines the selling entity for digital products. The Bill To column contains a two-letter country code.

The asterisk (*) represents a wildcard. When assigning a selling and buying entity, Digital River first attempts to make an exact match. If we cannot find an exact match, then we use the wildcards to make a partial match.

Determining when multiple orders are required

A Checkout or Order can only be assigned a single selling entity. If your request contains a combination of items that cannot be handled by a single selling entity, then a 400 Bad Request is returned:

{
    "type": "bad_request",
    "errors": [{
        "code": "selling_entity_not_found",
        "parameter": "items[].skuId",
        "message": "No Digital River selling entity allows you to sell this combination of items."
    }]
}

In these cases, you'll need to create two separate Orders. The following table lists two example scenarios where creating multiple Orders is required: