PHPackages                             belluno-finance-solutions/module-magento - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. belluno-finance-solutions/module-magento

ActiveMagento2-module[Payment Processing](/categories/payments)

belluno-finance-solutions/module-magento
========================================

Belluno Payments Integration Module

1.0.4(4y ago)01965[2 PRs](https://github.com/bellunodigital/magento2/pulls)OSL-3.0PHP

Since Oct 11Pushed 1y ago1 watchersCompare

[ Source](https://github.com/bellunodigital/magento2)[ Packagist](https://packagist.org/packages/belluno-finance-solutions/module-magento)[ RSS](/packages/belluno-finance-solutions-module-magento/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)DependenciesVersions (5)Used By (0)

[![](.github/images/belluno.png)](.github/images/belluno.png)

**[Belluno Payments Integration Module](README.md)**
====================================================

[](#belluno-payments-integration-module)

### *Installation*

[](#installation)

---

We recommend that you have a testing environment to validate changes and updates before updating your store in production. Also that all information is backed up before performing any update/installation procedure.

---

### **Compatibility Versions**

[](#compatibility-versions)

*Magento 2.4.X &amp; PHP 7.4*

*Magento 2.3.3 &amp; PHP 7.3*

### **Installation of Module**

[](#installation-of-module)

Download the module and follow the steps below:

[Belluno-Magento](https://github.com/bellunodigital/magento2)

#### Installation using composer

[](#installation-using-composer)

1. Install via packagist:

    ```
    composer require belluno-finance-solutions/module-magento

    ```

    At this time, you may be asked for your Magento authentication credentials. If in doubt, there is documentation that will help you. [Link](https://devdocs.magento.com/guides/v2.3/install-gde/prereq/connect-auth.html)
2. Execute this commands:

    - `bin/magento setup:upgrade`
    - `bin/magento setup:di:compile`
    - `bin/magento cache:clean`

#### Installation using GitHub

[](#installation-using-github)

If your store was created through the clone or download of the magento project, follow the next steps:

1. Extract the contents of the ZIP download and move the directory `belluno-magento2` into the folder `Belluno` and rename to `Magento2`
2. Check if your store directory looks like this `app/code/Belluno/Magento2`
3. Enable the module with the following command `bin/magento module:enable Belluno_Magento2`
4. Execute this commands:
    - `bin/magento setup:upgrade`
    - `bin/magento setup:di:compile`
    - `bin/magento cache:clean`

#### Module Settings

[](#module-settings)

Access the Magento Administrative Panel on the side menu click on `Stores`, then click on `Configuration`, next click on `Sales` and `Payment Methods`.

Scroll down until you find `Belluno Custom Payment`.

So you will have five configurations. *Follow the next steps to understand.*

#### 1 - Belluno Config

[](#1---belluno-config)

[![](.github/images/belluno-config.png)](.github/images/belluno-config.png)

- **Environment:** this option gives the possibility to place the module in a test environment or production environment.
    - `Production` - production environment;
    - `Sandbox` - test environment;
- **Sort Order:** this option lets you select an order that the method will appear at checkout. The smaller will appear first.

#### 2 - Belluno Authentication

[](#2---belluno-authentication)

[![](.github/images/belluno-auth.png)](.github/images/belluno-auth.png)

- **Authentication Token:** Belluno support team must provide a valid token for your environment.
- **Public Key Konduto:** this field must be provided by the Konduto support team, but Belluno makes the request to Konduto.

#### 3 - Belluno - Credit Card

[](#3---belluno---credit-card)

[![](.github/images/belluno-creditcard.png)](.github/images/belluno-creditcard.png)

- **Enabled:** this option gives the possibility to activate and deactivate the module.

    - `Yes` - activated;
    - `No` - disabled;
- **Rule of Capture:** here you define whether the capture will be automatic or manual.

    - `Authorize` - in this option the captures must be done manually by the administrator. It only authorizes purchases.
    - `Authorize and Capture` - in this option the authorization and capture are done automatically.
- **Installments:** here you can add or decrease the amount of installments that will be available.

    In each installment it is possible to put a number that will represent the percentage of interest on the total amount.

    - **Observation:** the ***number*** applied will always add the percentage referring to the ***total amount*** of the order, **NOT** the total amount with interest from the ***previous installment***.
- **Minimum value of installment:** this will be the minimum possible value of a single installment.
- **Title:** in this field you can change the name that will appear at checkout.
- **Capture tax document:** this field allows you to configure whether the client is to fill in your document or not.

    - `Yes` - customer will have to fill in their document at checkout.
    - `No` - customer will not have to fill in their document at checkout.
    - **Observation:** ***IF YOU MARK NO***, you must set the field "***Show Tax/VAT number***" as mandatory.

        - **Show Tax/VAT number:** `Stores` -&gt; `Configuration` -&gt; `Customers` -&gt; `Customer` `Configuration` -&gt; `show Tax/VAT Number`. **REQUIRED**.

            [![](.github/images/tax-vat.png)](.github/images/tax-vat.png)

#### 4 - Belluno - Bank Slip

[](#4---belluno---bank-slip)

[![](.github/images/belluno-bankslip.png)](.github/images/belluno-bankslip.png)

- **Enabled:** this option gives the possibility to activate and deactivate the module.

    - `Yes` - activated;
    - `No` - disabled;
- **Days to expiration:** number of days for the ticket to expire.
- **Title:** in this field you can change the name that will appear at checkout.
- **Capture tax document:** this field allows you to configure whether the client is to fill in your document or not.

    - `Yes` - customer will have to fill in their document at checkout.
    - `No` - customer will not have to fill in their document at checkout.
    - **Observation:** ***IF YOU MARK NO***, you must set the field "***Show Tax/VAT number***" as mandatory.

        - **Show Tax/VAT number:** `Stores` -&gt; `Configuration` -&gt; `Customers` -&gt; `Customer` `Configuration` -&gt; `show Tax/VAT Number`. **REQUIRED**.

            [![](.github/images/tax-vat.png)](.github/images/tax-vat.png)

#### 5 - General Configure

[](#5---general-configure)

- **Show Telephone:** `Stores` -&gt; `Configuration` -&gt; `Customers` -&gt; `Customer` `Configuration` -&gt; `Show Telephone`. **REQUIRED**.

    [![](.github/images/show-telephone.png)](.github/images/show-telephone.png)

#### Added functions

[](#added-functions)

In **view order** (), in cases of bank slip, a **button** was added so that the customer can reprint his bank slip.

[![](.github/images/billet.png)](.github/images/billet.png)

After clicking.

​ [![](.github/images/bankslip.png)](.github/images/bankslip.png)

- On the **admin page:**
    - In order, view (*`bank slip`*). A **button** was also added.

[![](.github/images/billet2.png)](.github/images/billet2.png)

After clicking, a new page will open to download or print the bank slip.

- On the **admin page:**
    - In order, view (*`credit card`*). A **button** was also added.

[![](.github/images/creditcard_view.png)](.github/images/creditcard_view.png)

After clicking.

[![](.github/images/payment_datail.png)](.github/images/payment_datail.png)

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance27

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 57.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~6 days

Total

4

Last Release

1653d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/77ef429758d9a0ea0ea8b2d8331081a6496f8ad4b157b3b4d380747abe43326e?d=identicon)[bellunodigital](/maintainers/bellunodigital)

---

Top Contributors

[![bellunodigital](https://avatars.githubusercontent.com/u/92052988?v=4)](https://github.com/bellunodigital "bellunodigital (11 commits)")[![edsontolazzi](https://avatars.githubusercontent.com/u/39594025?v=4)](https://github.com/edsontolazzi "edsontolazzi (6 commits)")[![LucasPereira762xi](https://avatars.githubusercontent.com/u/26752169?v=4)](https://github.com/LucasPereira762xi "LucasPereira762xi (1 commits)")[![ScopelEduardo](https://avatars.githubusercontent.com/u/88912413?v=4)](https://github.com/ScopelEduardo "ScopelEduardo (1 commits)")

### Embed Badge

![Health badge](/badges/belluno-finance-solutions-module-magento/health.svg)

```
[![Health](https://phpackages.com/badges/belluno-finance-solutions-module-magento/health.svg)](https://phpackages.com/packages/belluno-finance-solutions-module-magento)
```

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
