PHPackages                             codetech/laravel-eupago - 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. codetech/laravel-eupago

ActiveLibrary[Payment Processing](/categories/payments)

codetech/laravel-eupago
=======================

Eupago payment gateway integration for Laravel — Multibanco, MB WAY, PayShop and PaysafeCard payments.

v3.7.0(1mo ago)3483MITPHPPHP ^8.1CI passing

Since Jun 19Pushed 4w ago1 watchersCompare

[ Source](https://github.com/CodeTechAgency/laravel-eupago)[ Packagist](https://packagist.org/packages/codetech/laravel-eupago)[ RSS](/packages/codetech-laravel-eupago/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (10)Dependencies (46)Versions (28)Used By (0)

[![Laravel Eupago](https://raw.githubusercontent.com/CodeTechAgency/laravel-eupago/master/art/banner.png)](https://raw.githubusercontent.com/CodeTechAgency/laravel-eupago/master/art/banner.png)

Laravel Eupago
==============

[](#laravel-eupago)

[![Latest version](https://camo.githubusercontent.com/5fde63965e2292cc39229e750ff7ca24c39ccaf907fc7cc92a178b2fbcce792c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f436f6465546563684167656e63792f6c61726176656c2d65757061676f3f7374796c653d666c61742d737175617265)](https://github.com/CodeTechAgency/laravel-eupago/releases)[![Total downloads](https://camo.githubusercontent.com/dc3ccfe95426b8249ed38aca969f2b10e7fa6c34dc3c9322381c2a5127937194/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f6465746563682f6c61726176656c2d65757061676f3f7374796c653d666c61742d737175617265)](https://packagist.org/packages/codetech/laravel-eupago)[![Tests](https://camo.githubusercontent.com/a5f8f5c2df8837b54bb8a323fc15b75ed97881f6fcf4f5325ccac2b611c8d284/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f436f6465546563684167656e63792f6c61726176656c2d65757061676f2f72756e2d74657374732e796d6c3f6272616e63683d6d6173746572267374796c653d666c61742d737175617265266c6162656c3d7465737473)](https://github.com/CodeTechAgency/laravel-eupago/actions/workflows/run-tests.yml)[![GitHub license](https://camo.githubusercontent.com/a01e9e0bd15afee532c691ecf55901ba0588a93448447050c2cdfe47a2d4a7cc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f436f6465546563684167656e63792f6c61726176656c2d65757061676f3f7374796c653d666c61742d737175617265)](https://github.com/CodeTechAgency/laravel-eupago/blob/master/LICENSE)

Accept the payment methods used in Portugal — Multibanco references, MB WAY, PayShop, and PaysafeCard — in your Laravel application, through the [Eupago](https://www.eupago.pt) payment gateway. The package covers everything from creating a payment on any of your Eloquent models to the webhook that confirms it, behind a simple API.

Quick start
-----------

[](#quick-start)

```
composer require codetech/laravel-eupago
```

Publish the migrations:

```
php artisan vendor:publish --provider="CodeTech\EuPago\Providers\EuPagoServiceProvider" --tag=migrations
```

Run the migrations:

```
php artisan migrate
```

Set your Eupago credentials in `.env`:

```
EUPAGO_ENV=test
EUPAGO_API_KEY=demo-xxxx-xxxx-xxxx-xxx
EUPAGO_CHANNEL=demo
```

Add a payment method's trait to a model and create a payment — e.g. MB WAY:

```
use CodeTech\EuPago\Traits\HasMbWayReferences;

class Order extends Model
{
    use HasMbWayReferences;
}

$order = Order::find(1);

$reference = $order->createMbwayReference($order->value, $order->id, '912345678');
```

When the customer confirms the payment, the package validates Eupago's callback, marks the reference as paid, and fires an `MBWayReferencePaid` event.

Documentation
-------------

[](#documentation)

This package handles the full payment lifecycle — creating references, webhooks, status checks, refunds. To learn all about it, head over to [the extensive documentation](https://www.codetech.pt/open-source/laravel-eupago).

Upgrading from an older version? See the [upgrade guide](https://github.com/CodeTechAgency/laravel-eupago/blob/master/UPGRADE.md).

Changelog
---------

[](#changelog)

Every release is documented on the [GitHub releases page](https://github.com/CodeTechAgency/laravel-eupago/releases).

Contributing
------------

[](#contributing)

Contributions are welcome! Please read the [contributing guidelines](https://github.com/CodeTechAgency/laravel-eupago/blob/master/CONTRIBUTING.md) before opening an issue or pull request.

Security
--------

[](#security)

If you discover a security vulnerability, please follow the [security policy](https://github.com/CodeTechAgency/laravel-eupago/blob/master/SECURITY.md) — do not report it publicly.

Support
-------

[](#support)

If this package helps you, consider [starring the repository](https://github.com/CodeTechAgency/laravel-eupago) — it helps other developers discover it.

---

License
-------

[](#license)

**codetech/laravel-eupago** is open-sourced software licensed under the [MIT license](https://github.com/CodeTechAgency/laravel-eupago/blob/master/LICENSE).

About CodeTech
--------------

[](#about-codetech)

[CodeTech](https://www.codetech.pt) is a web development agency based in Matosinhos, Portugal. Oh, and we LOVE Laravel!

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance94

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~80 days

Recently: every ~4 days

Total

24

Last Release

34d ago

Major Versions

1.x-dev → v2.0.02026-06-24

v2.1.1 → v3.0.02026-06-25

PHP version history (4 changes)v1.0.0PHP ^8.0

v1.0.3PHP ^7.3|^8.0

v2.0.0PHP ^8.0.2

v3.0.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/6adaef8b30d5d0dee7bc2484fd9b0a9ad33e38afb78fc5d18d79d6239c811c76?d=identicon)[jfrosorio](/maintainers/jfrosorio)

---

Top Contributors

[![jfrosorio](https://avatars.githubusercontent.com/u/17640929?v=4)](https://github.com/jfrosorio "jfrosorio (65 commits)")

---

Tags

eupagolaravellaravel-packagembwaymultibancopayment-gatewayphpportugallaravelpaymentpaysafecardpayment gatewaymultibancombwayportugalEupagopayshop

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/codetech-laravel-eupago/health.svg)

```
[![Health](https://phpackages.com/badges/codetech-laravel-eupago/health.svg)](https://phpackages.com/packages/codetech-laravel-eupago)
```

###  Alternatives

[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9922.4M146](/packages/roots-acorn)[laravel/cashier

Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services.

2.6k31.8M162](/packages/laravel-cashier)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.4M354](/packages/psalm-plugin-laravel)[api-platform/laravel

API Platform support for Laravel

58190.1k21](/packages/api-platform-laravel)[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k16.3M154](/packages/laravel-pulse)[fleetbase/core-api

Core Framework and Resources for Fleetbase API

1239.7k25](/packages/fleetbase-core-api)

PHPackages © 2026

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