KEKS Pay

KEKS Pay mobile wallet as a Craft Commerce gateway. Installed on Croatian stores for two years before this release.

What it does

• Checkout: the payment form shows the QR code the KEKS Pay app reads and an app link for phones (gateway.getPaymentFormHtml({ order })). Submitting the Commerce payment form instead redirects straight into the app with the order's return and cancel URLs.
• Verified callback: the bank reports the result to keks-pay/keks/processing (or Commerce's generic webhook URL). The plugin checks the agreed token, matches the amount to the order total, records a purchase transaction and marks the order paid. Repeated callbacks for a paid order are acknowledged without a second transaction.
• Polling: the checkout page polls the order every five seconds and moves to the return URL once it is paid.
• Refund from the order's Transactions tab, signed with the 3DES request hash the KEKS Pay manual defines.
• Settings accept environment variables. Croatian translations for the control panel and the checkout strings.

Setup

1. composer require wmd/craft-keks-pay and install the plugin.
2. Settings → Plugins → KEKS Pay: CID, TID, key, callback token, UAT or production API host.
3. Commerce → Gateways → New gateway, type KEKS Pay.
4. Give KEKS Pay the callback URL the settings page prints.

Requirements

Craft CMS 5.0+, Craft Commerce 5.0+, PHP 8.2+ with OpenSSL.

KEKS Pay is a trademark of Erste & Steiermärkische Bank d.d.