Selling entities

Learn how Digital River dynamically assigns selling entities.

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.

JSON
JSON
{
...
"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 bill-to addresses for digital products. 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 is not one of your specified eligible entities, then we assign the order to Digital River, Inc.

Ship From

Ship To

Eligible Entity

Selling Entity Legal Name

Buying Entity Legal Name

US

*

*

Digital River, Inc.

Digital River, Inc.

US

*

DRGT

DR globalTech, Inc.

DR globalTech, Inc.

CA

CA

DRGT

DR globalTech, Inc.

DR globalTech, Inc.

AT

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

BE

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

CZ

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

DK

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

FI

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

FR

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

DE

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

IE

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

IT

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

LU

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

NE

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

PL

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

PT

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

ES

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

SE

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

GB

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

TW

TW

DRTW

DR Taiwan

DR Taiwan

CN

CN

DRCN

DR China

DR China

JP

JP

DRJP

DR Japan

DR Japan

KR

KR

DRKR

DR Korea

DR Korea

IN

IN

DRIN

Efulfillment Market Services Pvt. Ltd.

DR India

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.

Bill To

Eligible Entity

Selling Entity Legal Name

Buying Entity Legal Name

US

*

Digital River, Inc.

Digital River, Inc.

US

DRGT

DR globalTech, Inc.

DR globalTech, Inc.

CA

DRGT

DR globalTech, Inc.

DR globalTech, Inc.

TW

DRTW

DR Taiwan

DR Taiwan

TW

DRTWIC

DR Taiwan

Digital River Ireland Ltd.

JP

DRJP

DR Japan

DR Japan

JP

DRJPIC

DR Japan

Digital River, Inc.

KR

DRKR

DR Korea

DR Korea

KR

DRKRIC

DR Korea

Digital River Ireland Ltd.

CN

DRCN

DR China

DR China

BR

DRBR

DR Brazil

DR Brazil

IN

DRIN

Efulfilment Maret Services Pvt. LTD

DR India

*

*

Digital River Ireland Ltd.

Digital River Ireland Ltd.

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:

JSON
JSON
{
"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:

Item 1...

Item 2...

Scenario

is..

ships from...

ships to...

is assigned...

is..

ships from...

ships/bills to...

is assigned...

1

Physical

France

United States

Digital River Ireland Ltd.

Physical

United States

United States

DR globalTech, Inc.

2

Physical

United States

Spain

DR globalTech, Inc.

Digital

---

Spain

Digital River Ireland Ltd.