Monopay, Quick Start Guide
(for Ucommerce, SiteCore, Kentico)

The installation consists of 2 parts: a back end part and a front end part.

Backend

Monopay has made an integration for Ucommerce, SiteCore and Kentico. The description below is Ucommerce specific but the same procedures applies to SiteCore and Kentico. Contact us for more info.

Complete the following steps to install Monopay in Ucommerce:

  1. Login in to your Umbraco site backend.

  2. In the left navigation menu, choose Ucommerce.

  3. Choose Settings > Apps > Install app.

  4. Choose "Choose file" and navigate to the nupkg-fil that you have downloaded from Monopay.

  5. Click on "Upload".

The Monopays app is now beeing installed and needs to have the correct settings applied.

Go to Settings > Orders > Payment Methods and choose Monopay.

payment-method.jpg

Click on the "Common"-tab to set the following settings.

  1. ApiKey - Enter your unique Monopay api key. Contact Monopay to get the key.

  2. SuccessUrl - the relative url to the page, which is shown upon successfull payment.

  3. CancelUrl - the relative url to the page, which is shown if the payment is cancelled or interrupted.

  4. MerchantID - Enter your unique Monopay merchant id. Contact Monopay to get the key.

  5. AcquirePaymentPassword - a password, which is used, when the order is completed and the payment needs to be drawn from the customer.

Click on the "Save"-icon, to save your settings.

Now choose the "Access"-tab.

Country.jpg
  1. Check the "Product Catalog Groups"-box.

  2. Check the countries required.

  3. Click on the "Save"-icon to save your settings.

Now choose the"Pricing"-tab

  1. If possible, choose a price group for a currency and check the box in the line.

  2. Click on the "Save"-icon to save your settings.

Navigate to Settings > Orders > Shipping Methods and choose Monopay. Choose the "Access"-tab

  1. Check the "Product Catalog Groups"-box.

  2. Check the countries required.

  3. Click on the "Save"-icon to save your settings.

The Monopay app is now installed.

Contact monopay@monopay.com if you experience any problems.

Front end

The front end part consists of implementing Monopay into the check out flow, which can be done by making a “Pay now” or “Pay with Monopay”-button on the basket/cart page.

This can be done in the simplest form by using the following code:

<a href="/umbraco/surface/monopay/index" class="btn btn-secondary btn-large btn-success">  Use Monopay <i class="fa fa-arrow-right icon-white"></i></a>

The code links to a controller action. Download a controller example here. This file must be copied to the ”Controllers” folder and must be compiled with the rest of the project, so that it becomes a part of the project .dll file.

In short the action sends the content of the basket/cart through the Monopay integration, and the user is send from the webshop to Monopay to complete the payment.

Contact monopay@monopay.com for further questions or if you experience any problems.