Setting up Digital River's Distributor Model

Learn how to set up the Digital River Distributor Model.

Adding support for Digital River's Distributor Model within the connector provides Digital River with the necessary values for shipment. When an Adobe Shipment is created, the connector sends a DR API POST/fulfillments call that includes the subfulfillerId, distributorCost, shippingCost, and currencyvalues required for sales within the Distributor Model.

By default, those values are taken from the Adobe order_item and order schema and are populated when an order is placed via the save_distributor_info observer. The following examples show the Digital River configuration settings required for using the Digital River Distributor Model.

Digital River Settings > General Settings > Distributor Cost Currency

Product Attributes > Digital River Distributor Information

Since, in many cases, Custom Values are used, the values used for fulfillment are not known at the time of order placement, or they may be provided via integration with another platform.

If the amounts cannot be set via product attributes, thesave_distributor_info observer can be used as a guide to create a new observer for dr_place_order_success. With the new observer in place and the default observer disabled, the necessary values can be saved to order_item and the order to be used during fulfillment. As long as the order_item and order values are populated before Adobe Shipment creation via the observer or otherwise, they will be used within the fulfillments API call.

Another option is to create plugins for \Digitalriver\DrPay\Helper\Drapi::getItemDrDistributorInformation and \Digitalriver\DrPay\Helper\Drapi::getOrderDrDistributorInformation which allows for bypassing the order_item and order values and lets you possibly reach out to a third party system for the values.