---
title: "Getting Integration Started With Monri Online"
slug: "getting-started-with-monri-online"
updated: 2025-07-25T10:17:44Z
published: 2025-07-25T10:17:44Z
canonical: "docs.monri.com/getting-started-with-monri-online"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monri.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Integration Started With Monri Online

Merchant Services Domain WebPay

## **Introduction**

Monri Online [WebPay] provides online payment services for your web shop solution.

---

## **Requirements**

| Requirement | Details |
| --- | --- |
| Account on test environment | Contact Monri Sales and/or support for more details |
| Access to documentation | [Monri Online integration documentation](https://ipg.monri.com/en/documentation) |
| Additional information | If you don’t have any information yet please contact our sales [ecomm-prodaja@monri.com](mailto:ecomm-prodaja@monri.com) |

---

## What is next

## **Step 1: Sign In With Your Account**

- Login with your account here: [Monri Online test environment](https://ipgtest.monri.com/en/login)
- Set other information

## **Step 2: Initial Setup**

- Please find Monri Online setup here:
- Insert SuccessURL, CancelURL if applicable and CallbackURL.

## **Step 3: Choose Transaction & Integration type**

Please select what type of integration will be used if not already defined with our key account manager.

**Types of integrations by your use-case:**

- Simple PayByLink or PayByLink API integration
- Classic Web Shop (integration or addon/plugin/extension)
- Mobile solution (Mobile APP)
- Other (platform integration, cross-platform solutions, etc.)

**Type of transactions:**

- Authorization - First step of two-step authorization. In this step fund are ‘only’ reserved on the buyers/users account. Authorization is also known as pre-authorization.
- **Purchase** - Direct payment authorization where funds are immediately transferred form buyer's card to the merchants acquiring bank account.
- **Capture** - Second possible step of the two-step authorization. Funds are now transferred form buyer's card to the merchants acquiring bank account. Capture is also known as post-authorization.
- **Refund** - Funds are returned/refunded to the buyer/card user.
- **Void** - Second possible step of the the two-step authorization.

NOTE: For more information about transaction types please refer to: [Transaction Types](/v1/docs/transaction-types)

**Technical integrations:**

- Redirect
- Components
- Mobile (Monri SDK)
  - Android
  - iOS
- PayByLink API integration
- Lightbox
- Supported frameworks used for cross-platform mobile app development: Flutter, React Native, Ionic

## **Step 4: Additional Features**

- Callback & Webhooks
- Installments
- Discounts (BIN or Card targeted)
- Customers module
- Limitations on initial request:
  - Custom attributes
  - Rules
- Custom parameters

**Features that can only be set by the Monri support agent**:

- Monri tokenization *Note: one time setup needed from Monri side for test and production alike*
- Discounts
- Web-Hooks (back-off response mechanism for different authorization steps)
  - For declined transactions (*3DS decline is not included*)
  - For all other steps: approved or declined transactions for refund, void, authorization; tokenized card transactions

## **Step 5: Get Help**

- Contact our support for more information at [helpdesk@monri.com](mailto:helpdesk@monri.com).

## **Conclusion**

For any information regarding business side or something in the process is not clear, please contact our sales at [ecomm-prodaja@monri.com](mailto:ecomm-prodaja@monri.com).

*Transaction Type*

A two-step transaction process where funds are first reserved and then collected.

- **Step 1: Authorization (Internal: Authorization)**
  - **Action:** Also known as **Pre-authorization**. It verifies card validity and reserves (blocks) the specific amount on the cardholder’s account.
  - **Status:** Funds are not yet transferred, only "held" for a specific period (usually 7–30 days).
- **Step 2: Capture (Internal: Completion/Settlement)**
  - **Action:** Also known as **Post-authorization**. The process of confirming and collecting the previously reserved funds.
  - **Result:** Initiates the actual transfer of money from the cardholder to the merchant.
- **Key Benefit:** Allows merchants to verify stock or service availability before final payment (e.g., in hotels, car rentals, or e-commerce).

*Monri Services*

**Monri back-off response mechanism for approved transactions in a form of *POST request*.**

- **Redirect (Front-end)**
  - **Path:** Gateway → Browser → Merchant
  - **Reliability:** Medium (User might close the browser)
  - **Purpose:** Visual confirmation for the customer
  - **Visibility:** User sees the URL change in the browser
- **Callback (Back-end)**
  - **Path:** Gateway → Merchant’s Server
  - **Reliability:** High (Guaranteed delivery with retry attempts)
  - **Purpose:** System/Database update for the merchant
  - **Visibility:** Occurs invisibly in the background

*Monri Service*

Request merchant sends to Monri endpoint to initialize authorization.