Search by

wmd / craft-keks-pay

wmdhosting

KEKS Pay mobile wallet for Craft Commerce: app redirect or QR code at checkout, bank callback, refunds.

Package info

github.com/WMD-hosting/craft-keks-pay

Documentation

Type:craft-plugin

pkg:composer/wmd/craft-keks-pay

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

1.0.0 2026-09-20 19:36 UTC

Requires

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT eb0965515769cb43b0da82ee84471be33ff9990e

paymentgatewaywalletcommerceCraftqr-codecraftcmscroatiacraft-plugincraft-commercekekskeks-pay

Published on Packagist.org on 2026-09-20 19:38 UTC

This package is auto-updated.

Last update: 2026-09-20 19:39:26 UTC

README

KEKS Pay mobile wallet as a Craft Commerce gateway: the customer pays in the KEKS Pay app, reached through a deep link on the phone or by scanning the QR code on the checkout page, the bank calls back with the result, refunds from the control panel, Croatian translations.

Requirements

Craft CMS 5.0+, Craft Commerce 5.0+, PHP 8.2+ with OpenSSL, and a KEKS Pay e-retailer account (CID, TID and key from KEKS Pay, UAT access for testing).

Installation

composer require wmd/craft-keks-pay
php craft plugin/install keks-pay

Then Commerce → System Settings → Gateways → New gateway, type KEKS Pay.

Settings

Settings → Plugins → KEKS Pay

Setting Notes
CID, TID, Key issued by KEKS Pay; environment variables are supported
Callback token the bank sends it as Authorization: Token …; empty disables the check
App URL https://kekspay.hr/
API URL https://kekspayuat.erstebank.hr/ while testing; KEKS Pay gives you the production host
Logo shown next to the payment method, craft.keks.logo in templates
Fallback success / cancel URL used when the order carries no return or cancel URL

Give KEKS Pay the callback URL the settings page prints:

https://example.com/actions/keks-pay/keks/processing

Commerce's generic webhook URL (commerce/webhooks/process-webhook?gateway=ID) works as well.

How a payment runs

  1. The checkout's payment form shows the QR code and an "Open the KEKS Pay app" link (gateway.getPaymentFormHtml({ order })). Submitting the Commerce payment form instead redirects straight into the app with the order's return and cancel URLs.
  2. The customer confirms in the app. The bank calls the callback with status, message, bill_id and amount; the plugin checks the token, matches the amount to the order, records a purchase transaction and marks the order paid. Repeated callbacks for a paid order are acknowledged without duplicating the transaction.
  3. The checkout page polls keks-pay/keks/check-transaction every five seconds and moves to the order's return URL once it is paid.
  4. Refund from the order's Transactions tab, for the full amount, signed with the 3DES request hash the KEKS Pay manual defines.

Testing

Use the UAT API host with the test CID, TID and key KEKS Pay provides, and the KEKS Pay test app.

License

MIT. Developed by WMD. KEKS Pay is a trademark of Erste & Steiermärkische Bank d.d.