reachweb / resrv-payment-eurobank
Eurobank (Greece) payment gateway for Statamic Resrv.
Package info
github.com/reachweb/resrv-payment-eurobank
Type:statamic-addon
pkg:composer/reachweb/resrv-payment-eurobank
Requires
- php: ^8.4
- reachweb/statamic-resrv: ^6.5
- statamic/cms: ^6.0
Requires (Dev)
- orchestra/testbench: ^10.0 || ^11.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
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.