Step 8: Set up Digital River fulfillments

Learn how to set up Digital River fulfillments.

Fulfillment process

The following sequence diagrams show the interaction between Shopper, Salesforce B2B Commerce, the Digital River Salesforce B2B Commerce App, and Global Commerce.

Checkout

Salesforce kicks off the fulfillment process after it creates a CC Order. The following sequence diagram outlines the flow before fulfillment.

When the shopper reaches the payment methods page, Salesforce B2B Commerce creates a CC cart and sends an update order event to the Salesforce B2B Commerce App. The App uses Global Commerce (Commerce API) to create the shopper, get a full access token, update the shopper, and get the cart details. The App updates Salesforce with the tax details and the selling entity assigned to the order.

Fulfillment

The following sequence diagram outlines the flow during fulfillment.

When a cart is successfully submitted, Salesforce renders an Order Confirmation page and creates a CC Order. The CC Order triggers the fulfillment steps.

ERP/Fulfillment receives the order. When they fulfill the order, they update the Order Item Status to Shipped. Salesforce updates the order status to Complete and sends it to the App. The Salesforce B2B Commerce App sends a WebService EFN to Global Commerce. Global Commerce updates the status to Complete, updates funds to Settled, and Sends a WebService OCN. The App sends a response code when it receives the OCN.

The sequence diagram above outlines the flow of API fulfillment messages, URLs, and content during fulfillment.

Global Commerce sends a Digital River Order Fulfillment Information (OFI) notification to the App. The App creates a Digital River Fulfillment object with an order identifier and other order information to the shopper and then sends an OFI response code to Global Commerce.

Salesforce updates the order's Line Item status to Shipped. The App sends an Electronic Fulfillment Notification (EFN) for each line item, and Global Commerce sends a response. Once the App sends an EFN status for all line items, Global Commerce moves the order to the Completed state and captures the funds. Global Commerce then sends an Order Complete Notification (OCN) for the order to the App. The App updates the invoice as Paid and creates a new transaction for the capture to the shopper and then sends an OCN response code to Global Commerce.

Step 8a: Create a connected app

To create a connected app for Digital River Fulfillments, complete the following steps:

  1. Sign in to Salesforce B2B Commerce.

  2. Type app manager in the Quick Find field and press Enter.

  3. Click New Connected App.

  4. Provide your API name and your email address.

  5. Select Enable OAuth Settings.

  6. Select the Require Secret for Web Server Flow check box.

  7. Click Save. Allow 2-10 minutes for your changes to take effect on the server before using the connected app.

Step 8b: Create a profile

To create a profile and assign it to a Fulfillment Integration User, complete the following steps:

  1. Create a new profile:

Step 8c: Assign the Fulfillment Integration User to the Digital River Salesforce B2B Commerce App Permission Set

To add the new user to the Digital River Salesforce B2B Commerce App Permission Set:

  1. Click Permission Sets. The Permission Sets page appears.

Step 8d: Send OAuth information to Digital River

Your Digital River Project Manager needs your OAuth information to set up your OAuth Fulfillment flow. To collect and send the required information, complete the following steps:

  1. Click App Manager in the Quick Find field. ​

  2. Collect the following information from this page:

    • Consumer Key–This is your Digital River client ID.

    • Consumer Secret–This is your Digital River client secret.

  3. Click My Domain. The My Domain page appears.

  4. Send the following information to your Digital River Project Manager:

    • Your salesforce domain name, for example: https://<custom>.my.salesforce.com Where <custom> is the custom portion of your domain name where you will send the OFI or OCN notification.

    • Your Digital River client ID

    • Your Digital River client secret

    • Your grant_type is password

    • Your password. Your password is a combination of the Salesforce user name for your Fulfillment Integration User followed by their security token using the following format: <password><securitytoken> Note that there is no space between the password and the security token.

    Digital River will set up the Digital River B2B Commerce Fulfillment App under Manage Connected Apps.

Resources

Digital River uses the following resources for fulfillments:

  • Order-level Electronic Fulfillment Information (OFI) Notification–You need to wait for the OFI message from Digital River before you fulfill an order. <instance_url>/services/apexrest/digitalriverb2b/DROFINotification/

  • Order Completion Notification (OCN)–Digital River triggers an OCN once Digital River has received an EFN with a Shipped or Cancel status for every line item in the order. This message tells Salesforce that Digital River has settled the order.

OFI Notification

When Salesforce receives a successful response, it will create the Digital River Fulfillment object. The object includes the CC Order ID, DR Order ID, Status, and so on. This object is important for ElectronicFulfillment Notification.

If you look at the CC Order Item Detail, you will see the Order Item Status:

When you set the Order Item Status to Shipped, it creates a new DR (Digital River) Line Item Fulfillment Detail object.

A scheduler job that looks for Open or Pending statuses in the EFN Order Item Status field for this object runs every five minutes.

These line items are then sent in the EFN job to Digital River with a status of Shipped. When Digital River receives the Shipped status, we will capture the funds (submit the request for payment for the payment method).

The following statuses drive the Digital River payment processing:

Set up OAuth programmatically

Digital River has to set up the Digital River Salesforce B2B Commerce App under Manage Connected Apps before you can perform this step.

Read this section if you want to set up OAuth programmatically for fulfillment.

Get an access token

To initiate a session and get an access token, send a Token call to one of the following environments:

Setting token parameters

When you request a token, you'll need to provide the required parameters listed in the following table.

Example Get Access Token request and response

  1. Expand the collection that contains your fulfillment APIs and open the Get Access Token request.

  2. In the body of the request, provide the values for the required Token parameters, and click Send.

A successful response returns the token information:

The access_token is the Bearer code. The fulfiller uses this Bearer code when sending subsequent fulfillment API calls.

Send order-level Electronic Fulfillment Information (OFI)

You must wait for the OFI message from Digital River before you fulfill an order.

To send a POST OFI, use the following URL format:

/services/apexrest/digitalriverb2b/DROFINotification/

Example:

https://acme.my.salesforce.com/services/apexrest/digitalriverb2b/DROFINotification/

Setting DROFINotification parameters

Example POST DROFINotification request and response

  1. Expand the collection that contains your fulfillment APIs and open the POST DROFINotification request.

  2. Ensure the POST URL includes the instance_url from the Get Access Token response. and include the following suffix: /services/apexrest/digitalriverb2b/DROFINotification/ For example:https://tbdclient--docqa.my.salesforce.com/services/apexrest/digitalriverb2b/DROFINotification/

  3. Click Send.

Send Order Completion Notification (OCN)

Create a new access token before sending the OCN.

Digital River triggers an OCN once Digital River has received an EFN with a Shipped or Cancel status for every line item in the order. This message tells Salesforce that Digital River has settled the order.

To send the OCN, use the following URL format:

<Instance_url>/services/apexrest/digitalriverb2b/DROrderCompleteNotification/

Example:

https:// acme.my.salesforce.com/services/apexrest/digitalriverb2b/DROrderCompleteNotification/

Setting DROrderCompleteNotification parameters

Example POST DROrderCompleteNotification request and response

  1. Expand the collection that contains your fulfillment APIs and open the POST DROrderCompleteNotification request.

  2. Ensure the POST URL includes the instance_url from the Get Access Token response and include the following suffix: /services/apexrest/digitalriverb2b/DROrderCompleteNotification/ For example: https://tbdclient--docqa.my.salesforce.com/services/apexrest/digitalriverb2b/DROFINotification/

  3. Click Send.

Last updated