LokiCheckout_IwocaPay

This Magento 2 module is an add-on package to the LokiCheckout.

It makes the iwocapay_paylater and iwocapay_paynow payment methods of the iwocaPay module (Iwoca_Iwocapay) work inside the Loki Checkout.

Requirements

Iwoca_Iwocapay is a composer dependency of this package, so it is installed along with it. Without it enabled, this module stays completely inert.

Installation

Install this package via composer:

composer require loki-checkout/magento2-iwoca-pay

Next, enable this module:

bin/magento module:enable LokiCheckout_IwocaPay

Configuration

All settings are the ones of the iwocaPay module itself, under Stores > Configuration > Sales > Payment Methods > iwocaPay. The ones that change how this module behaves:

| Setting | Effect | |---|---| | Enabled (payment/iwocapay/active) | Master switch. Also needs a Seller ID, a Seller Access Token and a base currency listed in payment/iwocapay/allowed_currencies (["GBP"] by default) before either method is offered. | | Allowed payment terms (payment/iwocapay/allowed_payment_terms) | Pay Later Only hides Pay Now in the checkout. | | Show checkout banner (payment/iwocapay/price_banner_checkout_enabled) | Renders the instalment banner in the checkout. | | Instalment terms (payment/iwocapay/price_banner_{30d,3m,12m}_enabled) | The terms the banner advertises. With none enabled, the banner is not rendered. | | Banner VAT (payment/iwocapay/price_banner_vat) | excluding finances - and labels - the total minus tax. |

How it works

iwocaPay is an off-site gateway that is handed the order after Magento has placed it. Upstream drives that hand-off from its Knockout renderer, which Loki Checkout never loads. This module reproduces it, along with everything else upstream only implements in its Luma JavaScript:

1. Observer\CheckMethodEligibility withholds a method the shopper is not eligible for. Upstream only applies these limits client-side, in js/view/payment/iwocapay.js; server-side both methods are active whenever payment/iwocapay/active is set. Pay Later needs an order value between £150 and £30,000, Pay Now up to £30,000. Because it observes payment_method_is_active, the rule holds in the checkout, over REST and in GraphQL alike, and an ineligible method is refused by Magento\Quote\Model\Quote\Payment::importData() rather than merely hidden.
2. Payment\Icon\IconResolver renders the iwocaPay logo next to both methods.
3. loki-checkout.payment.methods.<code>.additional shows the configured subtitle under the selected method.
4. Payment\Redirect\RedirectResolver sends the shopper to iwocapay/process/createOrder once the order is placed. That upstream controller creates the order in iwocaPay and redirects on to the hosted payment page; its iwocapay/process/callback return leg then invoices the order and forwards to the success page.
5. ViewModel\CheckoutBanner renders the instalment banner, either in the order summary or underneath the payment methods once the shopper reaches them.

The rest of the upstream module needs no adaptation: the order confirmation email is already held back until iwocaPay confirms the payment, the success page already rehydrates a dropped session, and the back-button cart restore already recognises the Loki Checkout, which serves the standard checkout route.

Note on "Pay Later Only"

Upstream expresses this to its own checkout as isPayLaterOnly, a strict comparison of the whole stored array against ["PAY_LATER"]. This module instead tests whether PAY_NOW is among the configured terms. The two agree on every value the admin field can produce today; the membership test additionally survives a reordering of the stored terms and a future third option.

Note on the banner

Upstream publishes the banner configuration as window.iwocapayBannerConfig from an inline script. Under a nonce-based Content Security Policy that script is blocked, so this module renders the terms, theme and VAT setting server-side instead of reading that global.

Current status

Support

For getting support, create an Issue under the following project URL:

https://gitlab.yireo.com/loki-checkout/LokiCheckout_IwocaPay.git