Search by

reachweb / resrv-payment-eurobank

reachweb

Eurobank (Greece) payment gateway for Statamic Resrv.

Package info

github.com/reachweb/resrv-payment-eurobank

Homepage

Type:statamic-addon

pkg:composer/reachweb/resrv-payment-eurobank

Statistics

Installs: 337

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.1.0 2026-11-14 18:41 UTC

This package is auto-updated.

Last update: 2026-11-14 18:48:53 UTC


README

This add-on adds a Eurobank payment gateway to Statamic Resrv.

Requires Resrv 6.5 or later on Statamic 6 and PHP 8.4.

Documentation

Please refer to the Resrv documentation to learn more about how to install and configure this add-on.

Besides standard configuration, you need to set the following env variables:

  • EUROBANK_REDIRECT_URL: The URL that the Resrv will use to redirect for payment.
  • EUROBANK_MID: Your merchant ID.
  • EUROBANK_SECRET: Your secret code.

They are read in config/resrv-payment-eurobank.php, so they keep working after php artisan config:cache. To change that file, publish it with php artisan vendor:publish --tag=resrv-payment-eurobank-config.

Register the gateways in config/resrv-config.php:

'payment_gateways' => [
    'eurobank' => [
        'class' => \Reach\ResrvPaymentEurobank\Http\Payment\EurobankPaymentGateway::class,
    ],
    'eurobank-iris' => [
        'class' => \Reach\ResrvPaymentEurobank\Http\Payment\EurobankIrisPaymentGateway::class,
    ],
],

How payments are confirmed

The add-on sends Eurobank Resrv's webhook URL for the gateway, https://yoursite.com/resrv/api/webhook/{config key}, as the order's confirm and cancel URL. Eurobank posts the payment result there, and the add-on checks its digest, confirms the reservation and sends the customer on to the checkout-complete page, or to the payment page of a manual reservation. Resrv already excludes these routes from CSRF protection, so no CSRF exception is needed any more. You can remove the one earlier versions asked for.

The add-on keeps each order's return URL and the bank's answer in the Laravel cache for 90 days. Resrv reads them when a manual reservation's payment is resumed, cancelled, marked as paid or refunded. Use a persistent cache store and avoid clearing it on deploy: once an order is forgotten, it reads as cancelled, and a customer returning from the bank lands on the checkout-complete page (or the home page) instead of their payment page.

Ask Eurobank / Cardlink to enable background confirmation. It sends a copy of the result straight to the same URL, so a reservation is still confirmed when the customer's browser never makes it back from the bank.

Refunds

Refunds are made in the Eurobank back office. Refunding a Eurobank reservation in the Resrv control panel marks it refunded and reminds you to return the money yourself, and customers cannot cancel these reservations online for an automatic refund.

Cardlink protocol version

The add-on speaks version 2 of the Cardlink redirect specification: every request carries version=2, and requests and the bank's answers are signed with SHA-256. Releases up to v1.0.0 used the older format without a version field, signed with SHA-1.

Upgrading

Deploy when no payment is in progress. The bank's answer to a payment that was started before the upgrade no longer confirms the reservation:

  • From v1.0.0: the add-on rejects an answer signed with SHA-1.
  • From the Resrv 3 version: the bank posts back to the checkout-complete page instead of Resrv's webhook URL.

After upgrading, make one test payment per gateway (card and IRIS) to confirm that your merchant account accepts version 2.