Skip to main content
Install the Dintero Checkout module for Optimizely Commerce, formerly known as EPiServer Commerce.

​
Prerequisites

  • Optimizely Commerce (EPiServer Commerce) version 10.9 or later.
  • A Dintero account with API keys and a payment profile. See API client setup.

​
Install the module

Add the Dintero.Checkout.Episerver library from the Optimizely NuGet repository. The source code and reference implementation are available at github.com/Dintero/Dintero.Checkout.Episerver.

​
Configure the integration

1

Create a configuration page layout

Build a page layout named ConfigurePayment.ascx to manage these credentials from Dintero Backoffice:
  • Account ID
  • Client ID
  • Client Secret
  • Profile ID
2

Check for conflicting meta fields

Verify that a meta field named DinteroSessionId does not already exist in your system.
3

Create a DinteroPage instance

In EPiServer CMS, create a new instance of the DinteroPage page type.
4

Configure redirect pages

Add the following properties to your start page:
  • DinteroPaymentCancelPage: the page users land on after a failed authorization.
  • DinteroPaymentLandingPage: the page users land on after a successful authorization.
5

Create the payment method

Create a new payment method named Dintero with Dintero as the payment system identifier.

​
Custom post-processing (optional)

Implement the IPostProcessDinteroPayment interface to add custom logic that runs after authorization, capture, or refund.

​
Supported features

  • Capture and partial refunds at item level within the EPiServer admin.
Changes made in Dintero Backoffice are not automatically synced to EPiServer order management. Always capture and refund through EPiServer to keep order state consistent.
Last modified on June 18, 2026