mahocommerce/module-revolut

Revolut payment gateway integration for Maho

dev-main 2026-05-21 19:19 UTC

Requires

• php: >=8.3

Requires (Dev)

• friendsofphp/php-cs-fixer: *
• mahocommerce/maho: dev-main
• mahocommerce/maho-phpstan-plugin: *
• phpstan/phpstan: *
• phpstan/phpstan-deprecation-rules: *
• phpstan/phpstan-strict-rules: *
• rector/rector: *

OSL-3.0

README

Revolut payment gateway for Maho Commerce. The v1 ships Revolut Pay as a redirect checkout: the customer is sent to Revolut's hosted payment page, and the order is captured back in Maho via webhook.

Requirements

• PHP >= 8.3
• Maho Commerce
• A Revolut Business / Merchant account with API access

Installation

composer require mahocommerce/module-revolut

Configuration

1. Get the Merchant API key

In your Revolut Business dashboard — production at https://business.revolut.com, sandbox at https://sandbox-business.revolut.com — go to:

Merchant → APIs → Merchant API tab → API Keys → Sandbox API Secret key (or Production API Secret key when going live).

Click the eye icon and copy the full sk_... secret.

Important

Make sure you are on the Merchant API tab, not Business API. The Business API needs OAuth + JWT + certificates; this module does not use it. The Public key (pk_...) shown on the same screen is unused by v1 (redirect checkout, no JS widget) — ignore it.

2. Configure Maho and register the webhook

In Maho admin → System → Configuration → Sales → Payment Methods → Revolut — General Settings:

1. Sandbox Mode — on while testing, off in production
2. Merchant API Key — the sk_... from step 1
3. Click Save Config
4. Click Register Webhook

The module calls POST /api/1.0/webhooks on your behalf, registers https://<your-store>/revolut/webhook for the relevant order events, and stores the returned signing secret and webhook ID in the form. The signing secret is returned only once by Revolut, so the button is the easiest way to get it.

Note

The Revolut Merchant dashboard does not have a Webhooks UI — webhook management is API-only. If you'd rather do it by hand, run:

curl -X POST https://sandbox-merchant.revolut.com/api/1.0/webhooks \
  -H "Authorization: Bearer <sk_...>" \
  -H "Revolut-Api-Version: 2024-09-01" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://<your-store>/revolut/webhook","events":["ORDER_COMPLETED","ORDER_AUTHORISED","ORDER_PAYMENT_DECLINED","ORDER_PAYMENT_FAILED"]}'

Swap the host to https://merchant.revolut.com for production. Then paste the signing_secret from the response into the Webhook Signing Secret field.

To list / rotate / delete webhooks later:

• GET /api/1.0/webhooks — list all
• GET /api/1.0/webhooks/{id} — retrieve one (also returns signing_secret)
• POST /api/1.0/webhooks/{id}/rotate-signing-secret — rotate the secret
• DELETE /api/1.0/webhooks/{id} — delete

3. Enable Revolut Pay

Under Revolut — Revolut Pay:

• Enabled — Yes
• Title / Sort Order / Payment Action — to taste (Authorize Only vs. Authorize and Capture)

Development

This module ships with the standard Maho CI gates:

• PHPStan (level 8) — vendor/bin/phpstan analyze
• Rector (dry-run) — vendor/bin/rector -c .rector.php --dry-run
• PHP CS Fixer (dry-run) — vendor/bin/php-cs-fixer fix --dry-run
• PHP / XML syntax checks — automatic on CI

Run composer install and you can execute any of the above locally before pushing.