PHPackages                             briqpay/module-payments-hyva-checkout - 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. briqpay/module-payments-hyva-checkout

ActiveLibrary[Payment Processing](/categories/payments)

briqpay/module-payments-hyva-checkout
=====================================

Briqpay Payments module for Hyvä Checkout, providing seamless integration with Briqpay payment gateway.

v1.0.0(1mo ago)00OSL-3.0 OR AFL-3.0PHPPHP >=8.1CI passing

Since Apr 13Pushed 4w ago1 watchersCompare

[ Source](https://github.com/Briqpay-Extensions/briqpay-m2-hyva-checkout-extension)[ Packagist](https://packagist.org/packages/briqpay/module-payments-hyva-checkout)[ RSS](/packages/briqpay-module-payments-hyva-checkout/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

Briqpay Payments for Hyvä Checkout
==================================

[](#briqpay-payments-for-hyvä-checkout)

This extension integrates the [Briqpay](https://briqpay.com) payment gateway with [Hyvä Checkout](https://hyva.io/checkout).

**Author:** [Control Alt Delete BV](https://controlaltdelete.nl)

---

Requirements
------------

[](#requirements)

- PHP >= 8.3
- Magento 2.4.8
- Hyvä Checkout >= 1.3.8
- `hyva-themes/magento2-compat-module-fallback`
- `briqpay/module-payments` (base Briqpay module)

Installation
------------

[](#installation)

Install via Composer:

```
composer require briqpay/module-payments-hyva-checkout
bin/magento module:enable Briqpay_PaymentsHyvaCheckout
```

Configuration
-------------

[](#configuration)

This module does not introduce any new configuration options. It does have support for these options from the Briqpay module:

- **Payment Overlay** — Show a loading overlay while the payment is being processed.
- **Custom Decision Logic** — Enable custom decision handling via DOM events ( see [Custom Decision Logic](#custom-decision-logic) below).

### Payment Overlay

[](#payment-overlay)

When **Payment Overlay** is enabled, a loading indicator is shown while the payment is being processed. It subscribes to the Briqpay `paymentProcessStarted` and `paymentProcessCancelled` events to show and hide the overlay respectively.

### Custom Decision Logic

[](#custom-decision-logic)

When **Custom Decision Logic** is enabled, the module emits a `briqpayDecision` DOM event before finalising the payment. Your custom code can listen to this event, perform additional checks, and respond with a `briqpayDecisionResponse` event:

```
document.addEventListener('briqpayDecision', function (e) {
    // e.detail.data contains the Briqpay session data
    const approved = true; // your custom logic here

    document.dispatchEvent(new CustomEvent('briqpayDecisionResponse', {
        detail: {decision: approved}
    }));
});
```

If no response is received within 10 seconds, the decision defaults to `true`.

Running Tests
-------------

[](#running-tests)

End-to-end tests use [Playwright](https://playwright.dev):

```
# From the extension root
npx playwright test --ui
```

### Required store views

[](#required-store-views)

The tests expect two store views to be present:

Store view codeNameThemeCheckout type`hyva_default`Default Store ViewHyvä Default CSPDefault`hyva_onepage`Onepage Store ViewHyvä Default CSPOnepageThe `onepage` store view must have `hyva_themes_checkout/general/checkout` set to `onepage`, and `web/url/use_store` to `1`.

### Available test suites

[](#available-test-suites)

- `tests/End-2-End/checkouts/default.spec.ts` — places a successful order in the default Hyvä Checkout
- `tests/End-2-End/checkouts/onepage.spec.ts` — places a successful order in the Hyvä Checkout with the onepage configuration and verifies that the Briqpay iframe price updates when the shipping method changes

Override the base URL with the `BASE_URL` environment variable:

```
BASE_URL=https://your-store.example.com npx playwright test
```

Support
-------

[](#support)

- **Briqpay support:**
- **Developer guide:**

OSL-3.0 or AFL-3.0

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance92

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 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

Unknown

Total

1

Last Release

57d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7b9d817004ce784ccf07d976a5d606568ae49db5ef1d68a5c056f3f050608c0b?d=identicon)[Briqpay](/maintainers/Briqpay)

---

Top Contributors

[![michielgerritsen](https://avatars.githubusercontent.com/u/5858697?v=4)](https://github.com/michielgerritsen "michielgerritsen (11 commits)")

---

Tags

magentopaymentecommercemagento2Hyva Checkoutbriqpay

### Embed Badge

![Health badge](/badges/briqpay-module-payments-hyva-checkout/health.svg)

```
[![Health](https://phpackages.com/badges/briqpay-module-payments-hyva-checkout/health.svg)](https://phpackages.com/packages/briqpay-module-payments-hyva-checkout)
```

PHPackages © 2026

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