LogoLogo
System Status
  • Digital River API
  • Getting started
  • Using our services
    • Local pricing
    • Item classification
    • Subscriptions
    • e-Invoicing
  • Integration options
    • Low-code checkouts
      • Implementing a Prebuilt Checkout
      • Implementing a Components checkout
      • Offering local pricing
      • Using a shipping endpoint
      • Processing subscription acquisitions
      • Adding custom fields
      • Offering store credit
      • Displaying policies and getting consent
      • Collecting e-invoice information
      • Handling completed checkout-sessions
    • Direct integrations
      • Standard flow
      • Building checkouts
        • Checking out guest and registered customers
        • Describing line items
          • Setting the price of an item
          • Managing items with shared SKU identifiers
        • Providing address information
        • Handling shipping choice
        • Tax identifiers
        • Applying a discount
        • Setting the customer type
        • Providing the IP address
        • Selecting a currency
        • Initiating a charge
        • Setting the purchase location
        • Configuring taxes
        • Accessing regulatory fee information
        • Localizing invoices and credit memos
        • Providing an upstream identifier
        • Applying store credit
        • Handling e-invoicing requirements
        • Landed cost
        • Tax calculation inputs
        • Selling entities
        • Payment sessions
        • Applying store credit (legacy)
        • Country specs
      • Building payment workflows
        • Handling redirect payment methods
        • Handling delayed payment methods
      • Subscription acquisitions
        • Handling subscription acquisitions
        • Handling external subscription acquisitions
        • Subscription information
      • Digital River coordinated fulfillments
        • Checking inventory levels
        • Using shipping quotes
        • Reserving inventory items
        • Managing a fulfillment order
        • Cancelling a fulfillment order
    • Connectors
  • Order management
    • Processing orders
    • Handling a rejected order
    • Accessing invoices and credit memos
    • Fulfilling goods and services
    • Capturing and cancelling charges
    • Payment reauthorizations
    • Handling reversals
      • Return basics
        • Digital River coordinated returns
        • Third party coordinated returns
      • Refund basics
        • Issuing refunds
        • Refunding asynchronous payment methods
      • Disputes and chargebacks
    • Customer notifications
    • Responding to events
      • Events
        • Key event types
        • All event types
      • Webhooks
        • Creating a webhook
        • Digital River API safelist
        • Digital River signature
      • Expanding events
      • Preventing webhooks from getting disabled
    • Distributor model
  • Subscription Management
    • Managing a subscription
    • Managing an external subscription
  • Payments
    • Payment solutions
      • Drop-in payments
        • How Drop-in payments work
        • Drop-in payments integration guide
      • DigitalRiver.js with Elements
        • Elements integration guide
        • Configuring payment methods
          • Configuring Afterpay
          • Configuring Alipay+ (cross-border)
          • Configuring Alipay (domestic)
          • Configuring Amazon Pay
          • Configuring Apple Pay
          • Configuring Bancontact
          • Configuring BNP Paribas
          • Configuring BLIK
          • Configuring CCAvenue
          • Configuring Clearpay
          • Configuring Credit Cards
          • Configuring FPX Online Banking
          • Configuring Google Pay
          • Configuring iDEAL
          • Configuring Klarna
          • Configuring Konbini
          • Configuring Online Banking (IBP)
          • Configuring Online Banking (Korea Bank Transfer)
          • Configuring PayCo
          • Configuring PayPal
          • Configuring SEPA Direct Debit
          • Configuring Trustly
          • Configuring Wire Transfer
          • Common payment sources
          • Common payment objects
    • Supported payment methods
      • Afterpay
      • Alipay (domestic)
      • Alipay+ (cross-border)
      • Amazon Pay
      • Apple Pay
      • Bancontact
      • BNP Paribas
      • BLIK
      • CCAvenue
      • Clearpay
      • Credit Cards
      • FPX Online Banking
      • Google Pay
      • iDEAL
      • Klarna
      • Konbini
      • Korea Bank Transfer (Online Banking)
      • Online Banking (IBP)
      • Pay with Installments France
      • PayCo
      • PayPal
      • PayPal Billing Agreement
      • PayPal Credit
      • PayPal Pay in 3
      • PayPal Pay in 4
      • PayPal RatenZahlung (Installment Payment)
      • SEPA Direct Debit
      • Trustly
      • Wire Transfer
    • Source basics
      • Managing sources
      • Handling credit card sources
      • Retrieving sources
    • Authorization declines
    • PSD2 and SCA
      • How to ensure SCA compliance
    • Payment testing scenarios
  • Product management
    • Product basics
    • Managing SKUs
    • Using product details
    • Grouping SKUs
    • SKU-inventory item pairs
    • Managing inventory items
    • Regulatory fees
      • What are regulatory fees?
        • Fees terminology
        • Regulatory fee management
        • European regulatory fees
        • Compliance obligations
        • WEEE directive requirements
        • Copyright directive requirements
        • Compliance challenges
      • Managing regulatory fees
  • Customer management
    • Customer basics
    • Creating and updating customers
    • Setting up tax exemptions
    • Recording a customer's request to be forgotten
  • Financial reporting
    • Financials basics
    • Sales transactions
      • Returning a list of sales transactions
      • Getting a sales transaction by ID
    • Sales summaries
      • Returning a list of sales summaries
      • Getting a sales summary by ID
    • Payouts
      • Returning a list of payouts
      • Getting a payout by ID
      • Get a list of transactions included in payout by ID
  • Developer resources
    • Digital River API reference
    • DigitalRiver.js reference
      • Including DigitalRiver.js
      • Initializing DigitalRiver.js
      • DigitalRiver object
      • Elements
        • Amazon Pay element
        • Apple Pay elements
        • Google Pay elements
        • IBAN element
        • iDEAL element
        • Konbini elements
        • Compliance element
        • Offline Refund elements
        • Online Banking elements
        • Tax Identifier element
        • Invoice attribute element
        • Delayed Payment Instructions element
        • PayPal elements
      • Guidelines for capturing payment details
      • Security
      • Digital River payment objects
      • Error types, codes, and objects
    • DigitalRiverCheckout.js reference
      • Including DigitalRiverCheckout.js
      • Initializing DigitalRiverCheckout.js
        • DigitalRiverCheckout configuration object
      • DigitalRiverCheckout object
        • Configuring Prebuilt Checkout
          • Performing actions
          • Defining experience
        • Components
          • Configuring components
          • Address component
          • Shipping component
          • Tax identifier component
          • Invoice component
          • Wallet component
          • Payment component
          • Compliance component
          • Order summary component
          • Thank you component
        • Rendering a checkout button
          • Performing actions on the checkout button
        • Determining the checkout's status
      • Accessing country and currency
    • DynamicPricing.js reference
    • Postman collection
  • administration
    • Sign in
    • Digital River Dashboard
      • Digital River Dashboard quick start guide
      • Key features
      • Reset your password
      • Test and production environments
      • Account
        • Adding an account
        • Switching accounts
        • Account access
      • Profile settings
        • Viewing your personal information
        • Changing your password
        • Updating your phone number
        • Enabling multi-factor authentication
      • Finance
        • Payouts
          • Viewing your payout details
          • Filtering your payouts
          • Exporting your payouts
        • Sales summaries
          • Viewing your sales summaries details
          • Filtering your sales summaries
          • Exporting your sales summaries
          • Exporting your sales summary details
        • Transactions
          • Viewing your transaction details
          • Filtering your transactions
          • Exporting your transactions
      • Order management
        • Orders
          • Searching for orders
          • Filtering your orders
          • Viewing the order details
          • Cancelling items
          • Fulfilling items
          • Downloading an invoice
          • Downloading a credit memo
          • Creating shipping labels
          • Recording a customer's request to be forgotten
          • Viewing returns and refunds
          • Creating a return
          • Accepting a return
          • Creating a refund
          • Viewing the order's timeline
        • Checkouts
          • Searching for checkouts
          • Filtering your checkouts
          • Viewing the checkout details
        • Prebuilt Checkout links
          • Generate Prebuilt Checkout links
          • View and work with Prebuilt Checkout link details
          • Add a customer during Prebuilt Checkout
          • Add a product during Prebuilt Checkout
      • Customers
        • Viewing customer details
        • Searching for customers
        • Filtering your customers
        • Editing account information
        • Adding a customer
        • Tax IDs and certificates
          • Adding a tax certificate
          • Adding a tax ID
          • Deleting a tax ID
        • Metadata
          • Adding metadata
          • Editing metadata
        • Manage subscriptions from the Customer Details page
        • Disabling a customer
        • Recording a customer's request to be forgotten
        • Deleting a customer
      • Catalog
        • SKUs
          • Viewing the SKU details
          • Searching for SKUs
          • Filtering your SKUs
          • Adding a SKU
          • Editing a SKU
          • Deleting a SKU
          • Adding a fee to a SKU
          • Editing a fee
          • Deleting a fee
          • Viewing product tariff codes
        • Managing customer subscriptions from Digital River Dashboard
      • Developers
        • API keys
          • Updating your API version
          • Getting your API keys
          • Changing the API version for your key
          • Creating a restricted key
          • Editing a restricted key
          • Deleting a restricted key
          • Rotating keys
        • Webhooks
          • Creating a webhook
          • Editing a webhook
          • Deleting a webhook
          • Rotating a webhook's secret
        • API logs
          • Filtering the API log
          • Viewing the API log details
        • Event logs
          • Filtering the events log
          • Viewing the event details
      • Settings
        • Users and roles
          • Roles
          • Searching for a user by name or email
          • Filtering your users and roles
          • Adding a user
          • Editing a user
          • Deleting a user
        • Prebuilt Checkout
        • Payment methods
          • Viewing your payment methods
          • Viewing payment method details
            • Enabling currencies
            • Managing countries
          • Enabling or disabling a payment method
  • General Resources
    • eCompass
    • eCompass documentation
    • Release notes
      • 2024
      • 2023
      • 2022
      • 2021
      • 2020
      • 2019
    • Standards and certifications
      • Certification process
      • Compliance requirements
      • Documentation requirements
      • Integration checklists
        • Admin portal
        • Products and SKUs
        • Customers and tax exemptions
        • Checkouts, payment sources, and orders
        • Disclosures, compliance statements, and emails
        • Fulfillments and cancellations
        • Customer portal
        • Order refund synchronization
        • Reversals
        • Error handling
      • Test and use cases
    • Commerce infrastructure
    • Versioning
    • Glossary
Powered by GitBook
On this page
  • Order notifications
  • Order confirmation
  • Shipment notification
  • Successful cancellation
  • Failed cancellation
  • Delayed shipment, right to cancel (1st and 2nd notices)
  • Refund confirmation
  • Product return instructions
  • Subscription notifications
  • Triggering events
  • Acquisition confirmation
  • Trial conversion notification
  • Renewal reminder
  • Renewal confirmation
  • Subscription cancelled notification
  • Updated terms
  • Billing failed notification
  • Subscription failed notification
  • Payment method expiration
  1. Order management

Customer notifications

Gain a better understanding of what notifications to send to customers and what information to include in them

PreviousDisputes and chargebacksNextResponding to events

Last updated 2 months ago

You'll need to send messages (typically emails) to your customers throughout an eCommerce transaction. These notifications provide customers with information on their purchases and inform them of important events. They also help keep your customers engaged throughout the process, leading to a more positive shopping experience and potentially increasing brand loyalty.

You must send certain notifications to customers to access Digital River's business model.

In many cases, you can to listen for created by Digital River and use the data in these events to populate the emails before they get pushed to customers.

On this page, you'll find information on and , as well as the events in the Digital River APIs (when available) that can be used to trigger them.

Order notifications

In this section, you'll find basic information on what notifications to send to customers throughout an :

Order confirmation

This notification informs your customers that their order has been approved and is being processed. It provides customers with a record of their purchase and assures them that the transaction is authentic.

In (refer to for access information), you'll find a comprehensive list of what to include in this notification.

Notification information
Relevant attribute

The identifier of the order

id

A description of each product

name, (and optionally description, image, and url) in items[].productDetails

The cost of each product

items[].amount

Assessed taxes

totalTax

Applied discounts

totalDiscount

Shipping costs

totalShipping

Total amount of order

totalAmount

Shipment notification

Send this notification to customers when some or all of an order's goods have shipped. The message must indicate which items are in the shipment and ideally include delivery tracking information.

Notification information
Relevant attribute

The identifier of the order

orderId or orderDetails.id

A description of each shipped product

name, (and optionally description, image, and url) in orderDetails.items[].productDetails

The quantity of each shipped product

items[].quantity

The name of the designated carrier

trackingCompany

The designated carrier's tracking number

trackingNumber

A url that allows customers to access tracking details

trackingUrl

Successful cancellation

This notification informs customers that their order has been partially or fully cancelled. Regardless of the reason for the cancellation or who initiated the request, purchasers must be notified which items will not be fulfilled.

If your application supports partial order cancellations, then we recommend listening for fulfillment.created and using it to trigger this message.

Notification information
Relevant attribute

The identifier of the order

id

A description of each cancelled product

name, (and optionally description, image, and url) in items[].productDetails

The quantity of each cancelled product

items.quantity

Notification information
Relevant attribute

The identifier of the order

orderId or orderDetails.id

A description of each cancelled product

name, (and optionally description, image, and url) in orderDetails.items[].productDetails

The quantity of each cancelled product

items.cancelQuantity

Failed cancellation

If customers request to have an order partially or fully cancelled but you can't honor their request, send a notification informing them that their goods are still scheduled for fulfillment.

Delayed shipment, right to cancel (1st and 2nd notices)

If a shipment is delayed, notify customers and provide a revised date of when the goods are scheduled for delivery. If additional delays cause that date to be pushed out even further, send customers a second notice. In both messages, you must give customers the option to cancel their purchase.

Currently, no events in the Digital River APIs can trigger these delayed shipment notifications.

Refund confirmation

This notification confirms that a customer's refund request has been successfully processed.

Notification information
Relevant attribute

The order identifier

id

Total amount refunded on order

refundedAmount

The amount of each individual refund on the order (optional)

payment.charges[].refunds[].amount

Product return instructions

Subscription notifications

Triggering events

Acquisition confirmation

This notification informs customers that they have successfully acquired one or more subscription-based products.

Notification information
Relevant attribute

The identifier of the acquisition order

id

A description of each subscription product

For each items[] with subscriptionInfo, the

name, (and optionally description, image, and url) in productDetails

The cost of each subscription product

For each items[] with subscriptionInfo, the amount

Assessed taxes

totalTax

Applied discounts

totalDiscount

Shipping costs

totalShipping

Total amount of order

totalAmount

Trial conversion notification

This notification informs customers that their promotional trial period has ended, and they will be billed regularly for the subscription's products.

Notification information
Relevant attribute

Description of subscription

invoice.description

The date the free trial was activated

subscription.stateTransitions.activatedFree

The first scheduled billing date

subscription.nextInvoiceDate

A description of each product in the subscription

name, (and optionally description, image, and url) in invoice.items[].productDetails

The cost and quantity of each product in the subscription

amount and quantity in invoice.items[]

The payment method to be charged

invoice.payment.sources[]

Taxes to be assessed

invoice.totalTax

A subtotal of the amount that the customer is to be charged

invoice.subtotal

The total amount that the customer is to be charged

invoice.totalAmount

Renewal reminder

This notification reminds customers that their recurring products are scheduled to renew soon. It should include the subscription's name and a description of its goods, the amount the customer will be charged, and the upcoming billing date.

Notification information
Relevant attribute

Description of subscription

Start date of subscription

subscription.stateTransitions.activated

The next scheduled billing date

subscription.nextInvoiceDate

A description of each product in the subscription

name, (and optionally description, image, and url) in invoice.items[].productDetails

The cost and quantity of each product in the subscription

amount and quantity in invoice.items[]

Payment method to be charged

invoice.payment.sources[]

Taxes to be assessed

invoice.totalTax

A subtotal of the amount that the customer is to be charged

invoice.subtotal

The total amount that the customer is to be charged

invoice.totalAmount

Renewal confirmation

This notification informs customers that their subscription has been renewed and their designated payment method was successfully charged.

Notification information
Relevant attribute

The order identifier

invoice.orderId

Description of subscription

Start date of subscription

subscription.stateTransitions.activated

A description of each product in the subscription

name, (and optionally description, image, and url) in invoice.items[].productDetails

The cost and quantity of each product in the subscription

amount and quantity in invoice.items[]

The payment method that was charged

invoice.payment.sources[]

Assessed taxes

invoice.totalTax

Applied discounts

invoice.totalDiscount

A subtotal of the amount charged

invoice.subtotal

The total amount charged

invoice.totalAmount

Next scheduled billing date

subscription.nextInvoiceDate

Subscription cancelled notification

This notification informs customers that their request to cancel a subscription has been successfully processed. It should ideally contain details on the cancelled products.

Notification information
Relevant attribute

The effective cancellation date

stateTransitions.cancelled

A description of each cancelled subscription product

Updated terms

This notification informs customers of an update to their subscription's terms and conditions. It should describe the upcoming changes and provide a way for customers to cancel the subscription if they don't agree with them.

Notification information
Relevant attribute

The updated terms

A description of each product in the description

Billing failed notification

This notification informs customers that an unsuccessful attempt was made to charge the payment method funding their subscription. To avoid losing access to their recurring products, the message should contain instructions on how customers can update or replace this payment method.

Notification information
Relevant attribute

Description of subscription

Payment method that could not be charged

invoice.payment.sources[]

The number of unsuccessful billing attempts that have been made so far

invoice.attemptCount

A description of the products that customers will lose access to unless they take action

name, (and optionally description, image, and url) in invoice.items[].productDetails

Subscription failed notification

This message informs customers that their subscription has been deactivated because payment couldn't be collected during the designated billing period. You should include instructions on how customers can reactivate their subscriptions.

Notification information
Relevant attribute

Description of failed subscription

Description of products in failed subscription

The date that the subscription failed

stateTransitions.failed

Payment method expiration

Before a subscription's renewal, this message informs customers that the designated payment method has either expired or will expire before the scheduled renewal date. The notification should provide customers with a way to either update the subscription's current payment method or replace it with a new one.

Recommended of triggering event:

This same event type can also be used for .

Use the following table to learn which attributes in the contain values that can be used to populate the notification.

In (refer to for access information), you'll find a comprehensive list of what to include in this notification.

Recommended of triggering event:

Use the following table to learn which attributes in the contain values that can be used to populate the notification.

In (refer to for access information), you'll find a comprehensive list of what to include in this notification.

Recommended of triggering event: or

This is because the state of each items[] in an must be cancelled before Digital River creates an with a of order.cancelled.

For example, if an contains multiple items[], each with a quantity of 2, and a customer uses your site’s UI to request that only one of those line items be fully cancelled, and, after approving that request, your system sends a with an items[].cancelQuantity of 2, then Digital River generates fulfillment.created but not order.cancelled.

Use the following tables to learn which attributes in the contain values that can be used to populate the notification.

In (refer to for access information), you'll find a comprehensive list of what to include in this notification.

Unless , there are no in the Digital River APIs that can be used to trigger this failed cancellation message.

In (refer to for access information), you'll find a comprehensive list of what to include in this notification.

In (refer to for access information), you'll find a comprehensive list of what to include in this message.

Recommended of triggering event:

Use the following table to learn which attributes in the contain values that can be used to populate the notification.

This message instructs customers on how to return they've purchased.

In (refer to for access information), you'll find a comprehensive list of what to include in this notification.

Unless , no currently exist in the Digital River APIs that can be used to trigger this message.

This section provides basic information on what notifications to send customers throughout a subscription's lifecycle and provides guidance on each notification's potential .

Refer to (see for access information) to be provided with a comprehensive list of what's required and what's recommended in these messages.

If you're using , we indicate which of can be used to trigger each . However, if you engage a third-party subscription service (except for ), you'll need to listen for relevant triggering events emanating from that service.

Recommended of :

Use the following table to learn which attributes in the contain values that can be used to populate the notification.

Recommended of :

Use the following table to learn which attributes in the contain values that can be used to populate the notification.

For details, refer to in .

Recommended of :

Use the following table to learn which attributes in the contain values that can be used to populate the notification.

invoice.description For details, refer to in .

Recommended of :

Use the following table to learn which attributes in the contain values that can be used to populate the notification.

invoice.description For details, refer to in .

Recommended of :

Use the following table to learn which attributes in the contain values that can be used to populate the notification.

items[].skuId To access product details, use this identifier to .

Recommended of :

Use the following table to learn which attributes in the contain values that can be used to populate the notification.

planId To access the updated terms and conditions, use this identifier to .

items[].skuId To access product details, use this identifier to .

Recommended of :

Use the following table to learn which attributes in the contain values that can be used to populate the notification.

invoice.description For details, refer to in .

Recommended of :

Use the following table to learn which attributes in the contain values that can be used to populate the notification.

planId Use this identifier to and access description information. For details, refer to in .

items[].skuId To access product details, use this identifier to .

In the Digital River APIs, no currently exist that can be used to trigger this notification.

Digital River coordinates a fulfillment
events
events
subscription acquisition notifications
triggering event
Acquisition confirmation
Trial conversion notification
Renewal reminder
Renewal confirmation
Subscription cancelled notification
Updated terms
Billing failed notification
Subscription failed notification
Payment method expiration
configure webhook(s)
events
Required Purchase Notifications
order notifications
subscription notifications
Order confirmation
Shipment notification
Successful cancellations
Failed cancellations
Delayed shipments, right to cancel
Refund confirmation
Product return instructions
Required Purchase Notifications
event's
Required Purchase Notifications
Required Purchase Notifications
Digital River coordinates a fulfillment
Physical Goods Required Purchase Notifications
Required Purchase Notifications
Recommended Purchase Notifications
Subscription Purchase Notifications
Digital River's subscription service
event
subscription notification
acquisition confirmation notifications
triggering event
triggering event
triggering event
triggering event
triggering event
triggering event
triggering event
triggering event
data.object
type
physical products
Learning tools
Learning tools
Learning tools
Learning tools
Learning tools
Learning tools
Learning tools
type
data.object
type
type
type
data.object
type
data.object
type
data.object
type
data.object
type
data.object
type
data.object
type
data.object
type
data.object
type
data.object
type
data.object
Learning tools
MOR/SOR
order.accepted
fulfillment.created
fulfillment.created
order.cancelled
order.refunded
order.accepted
subscription.extended
subscription.reminder
subscription.extended
subscription.updated
subscription.updated
subscription.payment_failed
subscription.failed
order's lifecycle
event's
order
event
order
POST /fulfillments
event's
events
event's
event's
event's
event's
event's
event's
event's
event's
event's
name
Plans basics
name
Plans basics
name
Plans basics
retrieve the SKU
retrieve the plan
retrieve the SKU
name
Plans basics
retrieve the plan
name
Plans basics
retrieve the SKU