Integration checklists

An overview of the available integration checklists.

These MOR/SOR integration checklists are meant to assist developers and quality assurance teams. Each checklist covers features that we either require or highly recommend you build into your tool. We also provide sequence diagrams to help you conceptualize the various interactions.

You can use these checklists and sequence diagrams while developing and testing your commerce connector.

• Admin portal

• Products and SKUs

• Customers and tax exemptions

• Checkout, payment sources, and orders

• Disclosures, compliance statements, and emails

• Fulfillments and cancellations

• Customer portal

• Order refund synchronization

• Reversals

• Error handling

Completing these checklists helps ensure your commerce connector can pass the tool-specific certification, and that any client sites built with the tool can successfully complete the production checkout certification.

Sequence diagrams

The following sequence diagrams depict the core commerce flow, subscription acquisitions, merchant-initiated auto-renewals, key order, and fulfillment events, and how customers use their account portals to create and save payment sources. You can consult these sequence diagrams while working your way through the various integration checklists.

Core commerce flow

This diagram depicts the core commerce flow and shows the basic interactions between the customer, your commerce platform, the Digital River APIs, and Digital River's Global Commerce layer. The same diagram and accompanying text are on the Process flow page.

1MB

Core Commerce.png

image

Core commerce flow (with submit then redirect)

This diagram depicts an end-to-end commerce flow using the submit then redirect solution. For details on how to implement it, refer to Handling redirect payment methods.

899KB

Core Commerce - Submit then redirect.png

image

Subscription acquisitions

In this illustration, we depict the interactions that occur while using a third-party subscription service to build an acquisition checkout and process the order's response.

546KB

Subscription acquisitions.png

image

Subscription auto-renewals

219KB

Subscription auto-renewals.png

image

This diagram depicts a standard, merchant-initiated autorenewal that uses a third-party subscription service. In this sequence of events (other than being notified of successful and failed renewal attempts), customers don't actively interact with either the commerce platform or Digital River.

Order-related events and client fulfillments

This visualization shows the potential webhook events that are emitted when a POST/orders returns a state of in_review or pending payment. It also demonstrates how an order in an accepted state drives both fulfillments and cancellations and how to handle the order complete event.

585KB

Order and fulfillment events.png

image

Source creation in customer portals

In this sequence diagram, we demonstrate how customers can use their account portals to create payment sources in Drop-in that are ready for storage and how you can then save these sources to their accounts for use in future purchases. The interactions in this diagram occur outside of a standard checkout flow.

65KB

Create sources in customer portal.png

image