Skip to main content

Welcome to our Help Center!

Plugin for Dynamicweb

This guide shows you how to install and setup the Billwerk+ plugin for Dynamicweb.

dynamicweb_logo.png

DynamicWeb is a suite combining eCommerce, Marketing, product information management and CMS.

Summary:

  1. Installation

  2. Configuration

Installation

To get started you need to install the NuGet package manager. NuGet is a package manager, primarily used for packaging and distributing software written using the .NET framework.

Please use one of the three following ways :

  1. Visual Studio

  2. NuGet.org

  3. Manual

Visual Studio

Visual Studio is an integrated development environment from Microsoft. It is used to develop computer programs including websites, web apps, web services and mobile apps.

  1. In Visual Studio > Open your Dynamicweb solution.

  2. Then go to Tools > NuGet Package Manager.

  3. Click on Manage NuGet Packages for solution.

  4. Search Dynamicweb Reepay.

  5. Select NORRIQ.Dynamicweb.Ecommerce.CheckoutHandlers.Reepay

  6. Press Install.

    Install-The_Billwerk-Plugin-for-Dynamic-Web2.png
    Install-The_Billwerk-Plugin-for-Dynamic-Web3.png
NuGet.org

NuGet.org is a public host of NuGet packages. In its role as a public host, NuGet.org itself maintains the central repository of over 100,000 unique packages at nuget.org.

  1. Navigate to: NuGet Gallery | NORRIQ.Dynamicweb.Ecommerce.CheckoutHandlers.Reepay 1.1.3

  2. Copy the Package manager command.

  3. Open a NuGet command window on your PC.

  4. Navigate to your Dynamicweb solution.

  5. Paste the command taken from step 2.

Manual

Note

OBS be mindful of the required dependency to Dynamicweb. Ecommerce 1.2.10 / Dynamicweb 9.2.

  1. Download the NuGet package from NuGet Gallery | NORRIQ.Dynamicweb.Ecommerce.CheckoutHandlers.Reepay 1.1.3

  2. Press download package.

  3. Extract files via Winrar or 7Zip.

  4. Go to the lib folder > net461 or net472.

  5. Copy the files (NORRIQ.Reepay.Application.dll & NORRIQ.Reepay.dll) to your bin folder for the Dynamicweb solution.

    Install-The_Billwerk-Plugin-for-Dynamic-Web4.png
Configuration

  1. In Dynamicweb (/admin) go to Settings > Ecommerce > Orders > Payments.

  2. Click on New payment to create a Billwerk + Checkout handler.

    Install-The_Billwerk-Plugin-for-Dynamic-Web5.png

  3. See the standard Dynamicweb documentation for general setup information for a Dynamicweb payment method - Payment Methods (dynamicweb.com)

  1. Give the payment checkout handler a name.

    Note

    Optional – Give the checkout handler a description, Icon, and Icon (order list). There’s no function associated with these.

  2. Make sure that you have marked the gateway to active.

  3. Select what countries should have this gateway available.

  4. Select which users should have this gateway available.

  5. Select Checkout Handler (Shopping Cart v2).

    Install-The_Billwerk-Plugin-for-Dynamic-Web6.png

  1. Select Reepay from the dropdown menu “Checkout handler” – “Type”.

  2. Type your Private API key from Billwerk + Admin.

    1. Optional: Type your webhook secret from Billwerk + Admin, if you intend to set up Billwerk + with webhooks, it currently supports the settle and authorized event.

    2. Optional: Check Enable full transaction information - results in an additional call to Reepay if you wish to have the transaction information saved in Dynamicweb on the order.

      This is done regardless of this check if you do not have set up a webhook for settled and authorized.

    3. Optional: Check Generate a new customer object in Reepay for each session. If you would like to generate a new user in Billwerk + Admin for all transactions.

    4. Optional: Select a locale if you want to override the default setting in Billwerk + Admin.

    5. Optional: Set your own custom text on the Confirm Buy button in Billwerk + Admin.

    6. Optional: Check it’s a test Billwerk+- Admin gateway.

  3. Select what payment types you want to allow.

  4. To select all, mark the field and press CTRL+A or select multiple by holding down CTRL and left mouse click the specific ones you want.

    1. Optional: Select SCA mode for Billwerk+.

    2. Optional: Check to send individual order lines to Billwerk+ (default is just sending order total).

  5. Check Auto post mode, this will result in a Window checkout.

    1. Optional: If Auto post mode was not checked, select a template for which checkout type you would like to use.

      Included in this package:

      • Window checkout

      • Overlay checkout

      • Embedded checkout

    2. Optional: Select a cancel template and/or an error template to be rendered in cases where Billwerk+ redirects to the cancel or error address.

    3. Optional/Warning: Check Auto settle and capture order as soon as it is placed to settle the transaction immediately.

In this section: