Process flow

Understand the high-level sequences and interactions in the Digital River API.

The following sequence diagrams depict the interaction between the customer, your commerce platform, the Digital River API integration layer, and Digital River.

These diagrams are meant to outline Digital River's core capabilities, focusing specifically on:

  • Important states of the order life cycle

  • The sequence of major events in the Digital River API

  • The necessary data you must provide Digital River to utilize our authorized reseller of record business model

  • How checkouts, orders, events, fulfillments, and post-order processing works

SKU creation

Prior to creating a checkout or processing an order, you'll need to create your SKUs by providing, at a minimum, the product or service name, tax code, country of origin, and Export Control Classification Number. As the reseller of record, Digital River requests this data in order to adhere to local regulations and tax laws.


The following diagram outlines the pre-checkout interactions between the customer and your commerce platform. Digital River is not involved in these initial steps.

After customers have built a cart, initiated a checkout, and confirmed the cart details, they can select to checkout as either a guest or an authenticated user.

Click to enlarge

Creating a checkout

Digital River creates a Customer and a Checkout and then returns the selling entity, tax calculations, and the Digital River terms of sale to your commerce platform. This gives the customer the opportunity to review the terms before providing payment information.

Click to enlarge

Creating a source and order

You can use the DigitalRiver.js library to take payment method details from a customer and then pass the data to the create source method. Once the source identifier is returned via the DigitalRiver.js library, you finalize the checkout and create an order. When an order is created, Digital River authorizes the customer’s payment and moves the order into a submitted state, pending fulfillment.

Click to enlarge

Fulfilling an order

In the final steps, you fulfill the shopper's order. Once notified that the order is fulfilled, Digital River captures the customer's funds and closes the order. All post-order events, including checkouts, orders, and fulfillments, are managed via webhooks.

Click to enlarge