LogoLogo
System Status
2021-03-23
2021-03-23
  • 2021-03-23
  • Charges
  • Checkouts
  • Country specifications
  • Customers
  • Events
  • Fees
  • File links
  • Files
  • Fulfillment cancellations
  • Fulfillment orders
  • Fulfillment returns
  • Fulfillments
  • Inventory items
  • Inventory levels
  • Invoices
  • Orders
  • Payouts
  • Plans
  • Refunds
  • Reservations
  • Returns
  • Sales summaries
  • Sales transactions
  • Shipments
  • Shipping quotes
  • SKUs
  • SKU groups
  • Sources
  • Subscriptions
  • Tax identifiers
  • Webhooks
Powered by GitBook
On this page

Fees

PreviousEventsNextFile links

Last updated 5 months ago

The Fees resource in the Digital River API details financial obligations imposed as part of regulatory compliance. These fees are essential for ensuring products meet legal standards across different regions. By managing these fees effectively, businesses can maintain compliance and accurately calculate the final cost of their offerings. See for more information.

Gets a Fee by identifier

get

Retrieves the details of a fee. You must supply the unique identifier of the fee.

Authorizations
Path parameters
idstringRequired

Fee identifier.

Responses
200
OK
application/json
400
400 Bad Request
application/json
401
401 Unauthorized
application/json
403
403 Forbidden
application/json
404
404 Not Found
application/json
405
405 Method Not Allowed
application/json
406
406 Not Acceptable
application/json
408
408 Request Timeout
application/json
429
429 Too Many Requests
application/json
500
500 Internal Server Error
application/json
502
502 Bad Gateway Error
application/json
503
503 Service Unavailable Error
application/json
504
504 Gateway Timeout Error
application/json
get
GET /fees/{id} HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "id": "fee_1971b9b5-7d6b-49d5-b2a6-88ca7e53f750",
  "createdTime": "2025-05-08T15:45:52.698Z",
  "type": "weee",
  "skuId": "sku_7834561209",
  "category": "3. IT and Telecommunication Equipment",
  "value": "85\" Class Q900 QLED Smart 8K UHD TV.",
  "amount": 0.5,
  "battery": {
    "quantity": 2,
    "chemicalSystem": "Alkaline",
    "iecCode": "R20"
  },
  "complianceAgency": "text",
  "feeExemption": "exempt",
  "brandName": "Samsung",
  "weee": {
    "weeeRegistrationId": "text"
  },
  "weightAndUnits": "3.00 kg",
  "rateAndUnits": "2.00 EUR",
  "currency": "USD",
  "country": "US",
  "subdivisions": [
    "CA"
  ],
  "liveMode": false,
  "metadata": {
    "coupon": "iOS"
  },
  "updatedTime": "2025-05-08T15:45:52.698Z"
}

Deletes a fee by identifier

delete

Permanently deletes a fee. Supply the unique identifier of the fee.

Authorizations
Path parameters
idstringRequired

Fee ID

Responses
204
204 No Content
400
400 Bad Request
application/json
401
401 Unauthorized
application/json
403
403 Forbidden
application/json
404
401 Not Found
application/json
405
405 Method Not Allowed
application/json
406
406 Not Acceptable
application/json
408
408 Request Timeout
application/json
409
409 Conflict
application/json
429
429 Too Many Requests
application/json
500
500 Internal Server Error
application/json
502
502 Bad Gateway Error
application/json
503
503 Service Unavailable Error
application/json
504
504 Gateway Timeout Error
application/json
delete
DELETE /fees/{id} HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

  • GETReturns a list of fees
  • POSTCreates a fee
  • GETGets a Fee by identifier
  • POSTUpdates an existing Fee
  • DELETEDeletes a fee by identifier

Updates an existing Fee

post

Updates the specified Fee by setting the values of the parameters passed. Any parameters not provided remain unchanged.

Authorizations
Path parameters
idstringRequired

Fee identifier

Body
typestring · enumOptional

The type of fee.

Example: weeePossible values:
skuIdstringOptional

The unique identifer of the stock keeping unit associated with the fee.

Example: sku_7834561209
categorystringOptional

The category of the fee as defined by regulatory law.

Example: 3. IT and Telecommunication Equipment
valuestringOptional

The value of the product.

Example: 85" Class Q900 QLED Smart 8K UHD TV.
amountnumber · doubleOptional

The fee amount.

Example: 0.5
complianceAgencystringOptional

The unique identifier of the recycling agency associated with the product's jurisdiction.

feeExemptionstringOptional

Indicates whether business to business sales are exempt from paying the fee.

Example: exempt
brandNamestringOptional

The product's brand name.

Example: Samsung
weightAndUnitsstringOptional

The weight of the unit, minus packaging or batteries, and the unit of measurement applied to the weight.

Example: 3.00 kg
currencystringOptional

A three-letter ISO 4217 currency code.

Example: USD
countrystringOptional

A two-letter ISO 3166 country code.

Example: US
subdivisionsstring[]Optional

An array of ISO 3166-2 subdivision codes.

Example: ["CA"]
Responses
200
200 OK
application/json
400
400 Bad Request
application/json
401
401 Unauthorized
application/json
403
403 Forbidden
application/json
404
401 Not Found
application/json
405
405 Method Not Allowed
application/json
406
406 Not Acceptable
application/json
408
408 Request Timeout
application/json
409
409 Conflict
application/json
429
429 Too Many Requests
application/json
500
500 Internal Server Error
application/json
502
502 Bad Gateway Error
application/json
503
503 Service Unavailable Error
application/json
504
504 Gateway Timeout Error
application/json
post
POST /fees/{id} HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 439

{
  "type": "weee",
  "skuId": "sku_7834561209",
  "category": "3. IT and Telecommunication Equipment",
  "value": "85\" Class Q900 QLED Smart 8K UHD TV.",
  "amount": 0.5,
  "battery": {
    "quantity": 2,
    "chemicalSystem": "Alkaline",
    "iecCode": "R20"
  },
  "complianceAgency": "text",
  "feeExemption": "exempt",
  "brandName": "Samsung",
  "weee": {
    "weeeRegistrationId": "text"
  },
  "weightAndUnits": "3.00 kg",
  "currency": "USD",
  "country": "US",
  "subdivisions": [
    "CA"
  ],
  "metadata": {
    "coupon": "iOS"
  }
}
{
  "id": "fee_1971b9b5-7d6b-49d5-b2a6-88ca7e53f750",
  "createdTime": "2025-05-08T15:45:52.698Z",
  "type": "weee",
  "skuId": "sku_7834561209",
  "category": "3. IT and Telecommunication Equipment",
  "value": "85\" Class Q900 QLED Smart 8K UHD TV.",
  "amount": 0.5,
  "battery": {
    "quantity": 2,
    "chemicalSystem": "Alkaline",
    "iecCode": "R20"
  },
  "complianceAgency": "text",
  "feeExemption": "exempt",
  "brandName": "Samsung",
  "weee": {
    "weeeRegistrationId": "text"
  },
  "weightAndUnits": "3.00 kg",
  "rateAndUnits": "2.00 EUR",
  "currency": "USD",
  "country": "US",
  "subdivisions": [
    "CA"
  ],
  "liveMode": false,
  "metadata": {
    "coupon": "iOS"
  },
  "updatedTime": "2025-05-08T15:45:52.698Z"
}

Returns a list of fees

get

Get all Fees.

Authorizations
Query parameters
endingBeforestringOptional

A cursor for use in pagination. The endingBefore parameter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with xyz your subsequent calls can include endingBefore=xyz in order to fetch the previous page of the list.

startingAfterstringOptional

A cursor for use in pagination. The startingAfter parameter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with xyz, your subsequent calls can include startingAfter=xyz in order to fetch the next page of the list.

limitinteger · min: 1 · max: 100Optional

A limit on the number of objects returned. Limit can range between 1 and 100, and the default is 10.

typestringOptional

Only return fees of this type.

skuIdstringOptional

Only return fees for this sku.

categorystringOptional

Only return fees in this category.

countrystringOptional

Only returns fees for this country.

idsstring[]Optional

Only return objects with these IDs.

Responses
200
200 OK
application/json
400
400 Bad Request
application/json
401
401 Unauthorized
application/json
403
403 Forbidden
application/json
405
405 Method Not Allowed
application/json
406
406 Not Acceptable
application/json
408
408 Request Timeout
application/json
429
429 Too Many Requests
application/json
500
500 Internal Server Error
application/json
502
502 Bad Gateway Error
application/json
503
503 Service Unavailable Error
application/json
504
504 Gateway Timeout Error
application/json
get
GET /fees HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "hasMore": true,
  "data": [
    {
      "id": "fee_1971b9b5-7d6b-49d5-b2a6-88ca7e53f750",
      "createdTime": "2025-05-08T15:45:52.698Z",
      "type": "weee",
      "skuId": "sku_7834561209",
      "category": "3. IT and Telecommunication Equipment",
      "value": "85\" Class Q900 QLED Smart 8K UHD TV.",
      "amount": 0.5,
      "battery": {
        "quantity": 2,
        "chemicalSystem": "Alkaline",
        "iecCode": "R20"
      },
      "complianceAgency": "text",
      "feeExemption": "exempt",
      "brandName": "Samsung",
      "weee": {
        "weeeRegistrationId": "text"
      },
      "weightAndUnits": "3.00 kg",
      "rateAndUnits": "2.00 EUR",
      "currency": "USD",
      "country": "US",
      "subdivisions": [
        "CA"
      ],
      "liveMode": false,
      "metadata": {
        "coupon": "iOS"
      },
      "updatedTime": "2025-05-08T15:45:52.698Z"
    }
  ]
}

Creates a fee

post

This method adds a new fee to an existing SKU.

Authorizations
Body
typestring · enumRequired

The type of fee.

Example: weeePossible values:
skuIdstringRequired

The unique identifer of the stock keeping unit associated with the fee.

Example: sku_7834561209
categorystringRequired

The category of the fee as defined by regulatory law.

Example: 3. IT and Telecommunication Equipment
valuestringRequired

The value of the product.

Example: 85" Class Q900 QLED Smart 8K UHD TV.
amountnumber · doubleRequired

The fee amount.

Example: 0.5
complianceAgencystringOptional

The unique identifier of the recycling agency associated with the product's jurisdiction.

Example: WEEE_ecologic
feeExemptionstringOptional

Indicates whether business to business sales are exempt from paying the fee.

Example: exempt
brandNamestringOptional

The product's brand name.

Example: Samsung
weightAndUnitsstringOptional

The weight of the unit, minus packaging or batteries, and the unit of measurement applied to the weight.

Example: 3.00 kg
currencystringRequired

A three-letter ISO 4217 currency code.

Example: USD
countrystringRequired

A two-letter ISO 3166 country code.

Example: US
subdivisionsstring[]Optional

An array of ISO 3166-2 subdivision codes.

Example: ["CA"]
Responses
201
201 Created
application/json
400
400 Bad Request
application/json
401
401 Unauthorized
application/json
403
403 Forbidden
application/json
405
405 Method Not Allowed
application/json
406
406 Not Acceptable
application/json
408
408 Request Timeout
application/json
409
409 Conflict
application/json
429
429 Too Many Requests
application/json
500
500 Internal Server Error
application/json
502
502 Bad Gateway Error
application/json
503
503 Service Unavailable Error
application/json
504
504 Gateway Timeout Error
application/json
post
POST /fees HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 448

{
  "type": "weee",
  "skuId": "sku_7834561209",
  "category": "3. IT and Telecommunication Equipment",
  "value": "85\" Class Q900 QLED Smart 8K UHD TV.",
  "amount": 0.5,
  "battery": {
    "quantity": 2,
    "chemicalSystem": "Alkaline",
    "iecCode": "R20"
  },
  "complianceAgency": "WEEE_ecologic",
  "feeExemption": "exempt",
  "brandName": "Samsung",
  "weee": {
    "weeeRegistrationId": "text"
  },
  "weightAndUnits": "3.00 kg",
  "currency": "USD",
  "country": "US",
  "subdivisions": [
    "CA"
  ],
  "metadata": {
    "coupon": "iOS"
  }
}
{
  "id": "fee_1971b9b5-7d6b-49d5-b2a6-88ca7e53f750",
  "createdTime": "2025-05-08T15:45:52.698Z",
  "type": "weee",
  "skuId": "sku_7834561209",
  "category": "3. IT and Telecommunication Equipment",
  "value": "85\" Class Q900 QLED Smart 8K UHD TV.",
  "amount": 0.5,
  "battery": {
    "quantity": 2,
    "chemicalSystem": "Alkaline",
    "iecCode": "R20"
  },
  "complianceAgency": "text",
  "feeExemption": "exempt",
  "brandName": "Samsung",
  "weee": {
    "weeeRegistrationId": "text"
  },
  "weightAndUnits": "3.00 kg",
  "rateAndUnits": "2.00 EUR",
  "currency": "USD",
  "country": "US",
  "subdivisions": [
    "CA"
  ],
  "liveMode": false,
  "metadata": {
    "coupon": "iOS"
  },
  "updatedTime": "2025-05-08T15:45:52.698Z"
}
Regulatory fees