Subscriptions
Learn more about the subscriptions as they apply to Admin APIs.
Activate resource
The following describes some of the key attributes for activating a subscription.
Activation key
The activationKey
activates the subscription.
Activation date
The activationDate
is the subscription's activation date when the shopper activates or begins using the subscription and marks the start of the subscription period. This is the date when the subscription term begins. Digital River uses this date to renew the subscription if it is set to auto-renew. The activation date is essential because the other dates in the lifecycle (like billing) either begin with the activation date or depend on the activation date.
Expiration date
The expirationDate
is the date when the subscription expires.
Email resource
The following describes key attributes for a subscription's shipping and billing email address.
Email address
The emailAddress
is the updated billing and shipping email address for a subscription.
Expiration-date resource
The following describes some attributes of a subscription's expiration-date.
Expiration date
The expirationDate
is the date when the subscription expires.
Perpetual-price resource
The following describes some key attributes of a subscription's perpetual-price.
Perpetual unit price
The perpetualUnitPrice
is the perpetual unit price of the subscription product.
Add-ons
The addOns
is an array of objects. The objects are sub-components, features, or products that a shopper can add to their subscription product for an additional fee per renewal cycle. An add-on is incremental to the main subscription product and follows the subscription renewal cycle. During the lifecycle of a subscription, the shopper can add or remove the add-on products. When a shopper adds an add-on product to a subscription, Digital River renews the add-on product at the same time as the main subscription product until the shopper deactivates the add-on.
Preview resource
The following describes some key attributes in a subscription's preview.
Add-ons
The addOns
is an array of objects. The objects are sub-components, features, or products that a shopper can add to their subscription product for an additional fee per renewal cycle. An add-on is incremental to the main subscription product and follows the subscription renewal cycle. During the lifecycle of a subscription, the shopper can add or remove the add-on products. When a shopper adds an add-on product to a subscription, Digital River renews the add-on product at the same time as the main subscription product until the shopper deactivates the add-on.
Product
The product
object contains the product's identifier information.
id: The product identifier.
externalReferenceId: The product's external reference identifier.
Quantity
The quantity
is a numeric number that indicates the number of add-ons.
Prorated unit price
When the proratedUnitPrice
is present, it overrides all other prices and skips normal proration. When it is not present, Global Commerce pricing and proration apply.
Preview-cart resource
The following describes some of the key attributes in a subscription's preview-cart.
Add-ons
The addOns
is an array of objects. The objects are sub-components, features, or products that a shopper can add to their subscription product for an additional fee per renewal cycle. An add-on is incremental to the main subscription product and follows the subscription renewal cycle. During the lifecycle of a subscription, the shopper can add or remove the add-on products. When a shopper adds an add-on product to a subscription, Digital River renews the add-on product at the same time as the main subscription product until the shopper deactivates the add-on.
Product
The product
object contains the product's identifier information.
id: The product identifier.
externalReferenceId: The product's external reference identifier.
Quantity
The quantity
is a numeric number that indicates the number of add-ons.
Prorated unit price
When the proratedUnitPrice
is present, it overrides all other prices and skips normal proration. When it is not present, Global Commerce pricing and proration apply.
Reference-id resource
The following describes some of the key attributes in a subscription's reference-id.
External reference identifier
The externalReferenceId is the external reference identifier for the subscription.
Renewal-price source
The following describes some of the key attributes of a subscription renewal-price.
Renewal unit price
The renewalUnitPrice
is the price for the subscription's renewal unit.
Renewal-product resource
The following describes some of the key attributes of a subscription renewal-product.
Renewal product identifier
The renewalProductId
is the subscription's renewal product identifier.
Last updated