From 150597e005aa4ff4917a68463c5f81fc450be62c Mon Sep 17 00:00:00 2001
From: carmenmaymo <mayen22@gmail.com>
Date: Tue, 17 Dec 2024 15:40:53 +0100
Subject: [PATCH] Add payment library to repo

---
 lib/payment-gateway/.distignore               |   8 +
 lib/payment-gateway/CHANGELOG.md              |  97 +++
 lib/payment-gateway/composer.json             | 112 ++++
 lib/payment-gateway/index.php                 |  31 +
 .../ddev-wordpress-plugin-example.pot         |  36 +
 lib/payment-gateway/package.json              |  34 +
 lib/payment-gateway/psalm.xml.dist            | 150 +++++
 lib/payment-gateway/release.config.js         |  15 +
 lib/payment-gateway/resources/js/backend.js   |   1 +
 .../resources/js/blocks/index.js              |  67 ++
 .../src/Fields/ContentField.php               |  56 ++
 .../src/GatewayIconsRendererInterface.php     |  15 +
 lib/payment-gateway/src/I18n.php              |  56 ++
 .../src/NoopPaymentProcessor.php              |  16 +
 .../src/NoopPaymentRequestValidator.php       |  13 +
 .../src/NoopRefundProcessor.php               |  14 +
 .../src/PaymentFieldsRendererInterface.php    |  18 +
 lib/payment-gateway/src/PaymentGateway.php    | 619 ++++++++++++++++++
 .../src/PaymentGatewayBlocks.php              | 112 ++++
 .../src/PaymentGatewayModule.php              | 192 ++++++
 .../src/PaymentGatewayValidator.php           |  35 +
 .../src/PaymentProcessorInterface.php         |  10 +
 .../src/PaymentRequestValidatorInterface.php  |  15 +
 .../src/RefundProcessorInterface.php          |  20 +
 .../src/SettingsFieldRendererInterface.php    |  10 +
 .../src/SettingsFieldSanitizerInterface.php   |  23 +
 lib/payment-gateway/webpack.config.js         |  47 ++
 27 files changed, 1822 insertions(+)
 create mode 100644 lib/payment-gateway/.distignore
 create mode 100644 lib/payment-gateway/CHANGELOG.md
 create mode 100644 lib/payment-gateway/composer.json
 create mode 100644 lib/payment-gateway/index.php
 create mode 100644 lib/payment-gateway/languages/ddev-wordpress-plugin-example.pot
 create mode 100644 lib/payment-gateway/package.json
 create mode 100644 lib/payment-gateway/psalm.xml.dist
 create mode 100644 lib/payment-gateway/release.config.js
 create mode 100644 lib/payment-gateway/resources/js/backend.js
 create mode 100644 lib/payment-gateway/resources/js/blocks/index.js
 create mode 100644 lib/payment-gateway/src/Fields/ContentField.php
 create mode 100644 lib/payment-gateway/src/GatewayIconsRendererInterface.php
 create mode 100644 lib/payment-gateway/src/I18n.php
 create mode 100644 lib/payment-gateway/src/NoopPaymentProcessor.php
 create mode 100644 lib/payment-gateway/src/NoopPaymentRequestValidator.php
 create mode 100644 lib/payment-gateway/src/NoopRefundProcessor.php
 create mode 100644 lib/payment-gateway/src/PaymentFieldsRendererInterface.php
 create mode 100644 lib/payment-gateway/src/PaymentGateway.php
 create mode 100644 lib/payment-gateway/src/PaymentGatewayBlocks.php
 create mode 100644 lib/payment-gateway/src/PaymentGatewayModule.php
 create mode 100644 lib/payment-gateway/src/PaymentGatewayValidator.php
 create mode 100644 lib/payment-gateway/src/PaymentProcessorInterface.php
 create mode 100644 lib/payment-gateway/src/PaymentRequestValidatorInterface.php
 create mode 100644 lib/payment-gateway/src/RefundProcessorInterface.php
 create mode 100644 lib/payment-gateway/src/SettingsFieldRendererInterface.php
 create mode 100644 lib/payment-gateway/src/SettingsFieldSanitizerInterface.php
 create mode 100644 lib/payment-gateway/webpack.config.js

diff --git a/lib/payment-gateway/.distignore b/lib/payment-gateway/.distignore
new file mode 100644
index 00000000..185a70f6
--- /dev/null
+++ b/lib/payment-gateway/.distignore
@@ -0,0 +1,8 @@
+.distignore
+.ddev
+.git*
+tests/
+vendor/**/test*
+*.lock
+package-lock.json
+*.xml.*
diff --git a/lib/payment-gateway/CHANGELOG.md b/lib/payment-gateway/CHANGELOG.md
new file mode 100644
index 00000000..f32ab37a
--- /dev/null
+++ b/lib/payment-gateway/CHANGELOG.md
@@ -0,0 +1,97 @@
+# [1.6.0](https://github.com/inpsyde/payment-gateway/compare/1.5.2...1.6.0) (2024-11-19)
+
+
+### Features
+
+* Filterable checkout components ([#34](https://github.com/inpsyde/payment-gateway/issues/34)) ([76f8c16](https://github.com/inpsyde/payment-gateway/commit/76f8c1626f3360b9763c6210393a6f7a40a0ccd7)), closes [#35](https://github.com/inpsyde/payment-gateway/issues/35)
+
+## [1.5.2](https://github.com/inpsyde/payment-gateway/compare/1.5.1...1.5.2) (2024-11-13)
+
+
+### Bug Fixes
+
+* allow node 22 ([1a28fdd](https://github.com/inpsyde/payment-gateway/commit/1a28fdd38be46459d1c63cd99192d9f2bc22e25d))
+* allow node 22 ([93a85e6](https://github.com/inpsyde/payment-gateway/commit/93a85e69eb329620dc636180298253ac18742a66))
+
+## [1.5.1](https://github.com/inpsyde/payment-gateway/compare/1.5.0...1.5.1) (2024-09-23)
+
+
+### Bug Fixes
+
+* Fix PaymentGatewayBlocks::$gateway type. ([#31](https://github.com/inpsyde/payment-gateway/issues/31)) ([58cd64c](https://github.com/inpsyde/payment-gateway/commit/58cd64cb64bc11fcd1a89d9aa0690d90738162a4))
+
+# [1.5.0](https://github.com/inpsyde/payment-gateway/compare/1.4.1...1.5.0) (2024-09-20)
+
+
+### Bug Fixes
+
+* code style, remove PaymentGatewayBlocks::$name type ([32ed490](https://github.com/inpsyde/payment-gateway/commit/32ed490e73414383c6f6eb34529a483468afb56c))
+
+
+### Features
+
+* Allow to interrupt refund with a message ([e5c6e10](https://github.com/inpsyde/payment-gateway/commit/e5c6e10d06b228483b8725cfbd41686fb0c5b776))
+
+## [1.4.1](https://github.com/inpsyde/payment-gateway/compare/1.4.0...1.4.1) (2024-09-18)
+
+
+### Bug Fixes
+
+* use variable in process_refund() ([afabd5c](https://github.com/inpsyde/payment-gateway/commit/afabd5cc6e08a830238af5067500df3fb462644f))
+
+# [1.4.0](https://github.com/inpsyde/payment-gateway/compare/1.3.2...1.4.0) (2024-09-13)
+
+
+### Features
+
+* [PROD-169] Implement l10n for errors & order notes ([#26](https://github.com/inpsyde/payment-gateway/issues/26)) ([7806c79](https://github.com/inpsyde/payment-gateway/commit/7806c798bc1a6e450f91d703fc94f7c07e8aea96)), closes [#1](https://github.com/inpsyde/payment-gateway/issues/1) [#2](https://github.com/inpsyde/payment-gateway/issues/2)
+
+## [1.3.2](https://github.com/inpsyde/payment-gateway/compare/1.3.1...1.3.2) (2024-07-12)
+
+
+### Bug Fixes
+
+* Keep frontend source and composer.json in releases ([ee1f8a3](https://github.com/inpsyde/payment-gateway/commit/ee1f8a3642d9240927b8df39b70e8022b000ad4f))
+
+## [1.3.1](https://github.com/inpsyde/payment-gateway/compare/1.3.0...1.3.1) (2024-07-01)
+
+
+### Bug Fixes
+
+* Do not use PHP_INT_MIN for hooks ([8e5e15d](https://github.com/inpsyde/payment-gateway/commit/8e5e15d4f09364333b5937a2d09b44210fe0c2f4))
+* Move comment outside of expression ([c80b6cd](https://github.com/inpsyde/payment-gateway/commit/c80b6cde33661b53fe0ac73824f5eaae3fda9db7))
+
+# [1.3.0](https://github.com/inpsyde/payment-gateway/compare/1.2.0...1.3.0) (2024-06-05)
+
+
+### Features
+
+* Add locators for method title & description ([#24](https://github.com/inpsyde/payment-gateway/issues/24)) ([27a73a9](https://github.com/inpsyde/payment-gateway/commit/27a73a90965af918da92185526315a97ab8b8c48))
+
+# [1.2.0](https://github.com/inpsyde/payment-gateway/compare/1.1.1...1.2.0) (2024-06-05)
+
+
+### Features
+
+* Check required services during init  ([79ae2b9](https://github.com/inpsyde/payment-gateway/commit/79ae2b9bb178376419c91b418bdfa2b593b99346)), closes [#15](https://github.com/inpsyde/payment-gateway/issues/15)
+
+## [1.1.1](https://github.com/inpsyde/payment-gateway/compare/1.1.0...1.1.1) (2024-06-04)
+
+
+### Bug Fixes
+
+* don't register gateway for blocks if disabled ([e577b52](https://github.com/inpsyde/payment-gateway/commit/e577b522ef0452104a2e54c499f39e9953876a38))
+
+# [1.1.0](https://github.com/inpsyde/payment-gateway/compare/1.0.1...1.1.0) (2024-06-04)
+
+
+### Features
+
+* Add a new service to allow skipping blocks registration ([#21](https://github.com/inpsyde/payment-gateway/issues/21)) ([e1978d1](https://github.com/inpsyde/payment-gateway/commit/e1978d19654a2c685265a9d32fa12ff49c7b6249))
+
+# 1.0.0 (2024-05-21)
+
+
+### Bug Fixes
+
+* specify playwright dependency ([1060e5c](https://github.com/inpsyde/payment-gateway/commit/1060e5cafece37c465e6e78077d2c7378f723b46))
diff --git a/lib/payment-gateway/composer.json b/lib/payment-gateway/composer.json
new file mode 100644
index 00000000..b13040dd
--- /dev/null
+++ b/lib/payment-gateway/composer.json
@@ -0,0 +1,112 @@
+{
+    "name": "inpsyde/payment-gateway",
+    "type": "inpsyde-module",
+    "description": "",
+    "license": "GPL-2.0",
+    "authors": [
+        {
+            "name": "Inpsyde GmbH",
+            "homepage": "https://inpsyde.com/",
+            "email": "hello@inpsyde.com",
+            "role": "Company"
+        }
+    ],
+    "repositories": [
+        {
+            "type": "composer",
+            "url": "https://repo.packagist.com/inpsyde/"
+        }
+    ],
+    "require": {
+        "php": "^7.4 | ^8.0",
+        "inpsyde/modularity": "^1.5"
+    },
+    "require-dev": {
+        "brain/monkey": "^2.0",
+        "brainmaestro/composer-git-hooks": "^2.8",
+        "inpsyde/composer-assets-compiler": "^2.5",
+        "inpsyde/ddev-tools": "dev-main",
+        "inpsyde/php-coding-standards": "^2.0",
+        "inpsyde/wp-translation-downloader": "^2.4",
+        "mockery/mockery": "^1.3",
+        "phpunit/phpunit": "^8.0 | ^9.0",
+        "php-stubs/wordpress-stubs": "^5.0@stable",
+        "php-stubs/woocommerce-stubs": "^5.0@stable",
+        "vimeo/psalm": "^4.3"
+    },
+    "autoload": {
+        "psr-4": {
+            "Inpsyde\\PaymentGateway\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Inpsyde\\PaymentGateway\\Test\\": "tests/PHPUnit/Helper"
+        }
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true,
+    "scripts": {
+        "phpcs": "@php ./vendor/bin/phpcs -n -s --parallel=24",
+        "phpcs:phpcbf": "@php ./vendor/bin/phpcbf  --parallel=24;exit 0",
+        "phpcs:interactive": "@php ./vendor/bin/phpcs -a",
+        "phpcs:dev": [
+            "@cs:phpcbf",
+            "@cs:interactive"
+        ],
+        "phpunit": "vendor/bin/phpunit",
+        "test": [
+            "@phpunit"
+        ],
+        "cghooks": "vendor/bin/cghooks",
+        "post-install-cmd": [
+            "@cghooks add --ignore-lock"
+        ],
+        "post-update-cmd": [
+            "@cghooks update"
+        ]
+    },
+    "config": {
+        "sort-packages": true,
+        "optimize-autoloader": true,
+        "allow-plugins": {
+            "dealerdirect/phpcodesniffer-composer-installer": true,
+            "inpsyde/composer-assets-compiler": true,
+            "composer/installers": true,
+            "inpsyde/wp-translation-downloader": true
+        }
+    },
+    "extra": {
+        "hooks": {
+            "pre-commit": [
+                "vendor/bin/phpcbf -q --parallel=24; exit 0"
+            ]
+        },
+        "wp-translation-downloader": {
+            "auto-run": false,
+            "languageRootDir": "./",
+            "languages": [
+                "de_DE",
+                "en_US"
+            ],
+            "api": {
+                "names": {
+                    "inpsyde/*": "https://translate.inpsyde.com/products/api/translations/%projectName%"
+                }
+            },
+            "directories": {
+                "names": {
+                    "inpsyde/*": "languages/"
+                }
+            }
+        },
+        "composer-asset-compiler": {
+            "auto-run": false,
+            "dependencies": "install",
+            "script": "build",
+            "default-env": {
+                "WEBPACK_ENV": "production"
+            }
+        }
+    }
+}
diff --git a/lib/payment-gateway/index.php b/lib/payment-gateway/index.php
new file mode 100644
index 00000000..4d2383de
--- /dev/null
+++ b/lib/payment-gateway/index.php
@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * Plugin Name: ddev-wordpress-plugin-example
+ * Plugin URI:  https://inpsyde.com
+ * Description: {DESCRIPTION}
+ * Version:     {VERSION}
+ * SHA:         ${GIT_SHA}
+ * Requires at least: 5.8
+ * Requires PHP: 7.2
+ * WC requires at least: 4.3
+ * WC tested up to: 5.5
+ * Author:      Inpsyde
+ * Author URI:  https://inpsyde.com
+ * License:     GPL-2.0
+ * Text Domain: ddev-wordpress-plugin-example
+ * Domain Path: /languages
+ */
+
+add_action('rest_api_init', function () {
+    register_rest_route('inpsyde', 'example', [
+        'method' => 'GET',
+        'callback' => function () {
+            return ['hello' => __('world', 'ddev-wordpress-plugin-example')];
+        },
+        'permission_callback' => '__return_true',
+    ]);
+});
+
+
diff --git a/lib/payment-gateway/languages/ddev-wordpress-plugin-example.pot b/lib/payment-gateway/languages/ddev-wordpress-plugin-example.pot
new file mode 100644
index 00000000..2ac5537a
--- /dev/null
+++ b/lib/payment-gateway/languages/ddev-wordpress-plugin-example.pot
@@ -0,0 +1,36 @@
+# Copyright (C) 2023 Inpsyde
+# This file is distributed under the GPL-2.0.
+msgid ""
+msgstr ""
+"Project-Id-Version: ddev-wordpress-plugin-example {VERSION}\n"
+"Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/ddev-wordpress-plugin-example\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"POT-Creation-Date: 2023-02-01T14:03:42+00:00\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"X-Generator: WP-CLI 2.7.1\n"
+"X-Domain: ddev-wordpress-plugin-example\n"
+
+#. Plugin Name of the plugin
+msgid "ddev-wordpress-plugin-example"
+msgstr ""
+
+#. Plugin URI of the plugin
+#. Author URI of the plugin
+msgid "https://inpsyde.com"
+msgstr ""
+
+#. Description of the plugin
+msgid "{DESCRIPTION}"
+msgstr ""
+
+#. Author of the plugin
+msgid "Inpsyde"
+msgstr ""
+
+#: ddev-wordpress-plugin-example.php:25
+msgid "world"
+msgstr ""
diff --git a/lib/payment-gateway/package.json b/lib/payment-gateway/package.json
new file mode 100644
index 00000000..ba7a3303
--- /dev/null
+++ b/lib/payment-gateway/package.json
@@ -0,0 +1,34 @@
+{
+    "name": "@inpsyde/generic-payment-gateway",
+    "version": "0.1.0",
+    "engines": {
+        "node": "^16 || ^18 || ^20 || ^22"
+    },
+    "devDependencies": {
+        "@semantic-release/changelog": "^6.0.3",
+        "@semantic-release/commit-analyzer": "^12.0.0",
+        "@semantic-release/exec": "^6.0.3",
+        "@semantic-release/git": "^10.0.1",
+        "@semantic-release/github": "^10.0.3",
+        "@semantic-release/npm": "^12.0.0",
+        "@semantic-release/release-notes-generator": "^13.0.0",
+        "@woocommerce/dependency-extraction-webpack-plugin": "3.0.0",
+        "@woocommerce/settings": "^1.0.0",
+        "@wordpress/hooks": "^4.11.0",
+        "@wordpress/html-entities": "^3.39.0",
+        "@wordpress/i18n": "^4.39.0",
+        "@wordpress/scripts": "^26.10.0",
+        "semantic-release": "^23.0.8",
+        "ts-loader": "^9.0.0",
+        "typescript": "^5.1.6"
+    },
+    "scripts": {
+        "build": "wp-scripts build",
+        "build:dev": "wp-scripts build --mode development",
+        "dev": "wp-scripts build --mode development --watch",
+        "start": "wp-scripts start",
+        "lint:md": "wp-scripts lint-md-docs docs/**/*.md",
+        "lint:js": "wp-scripts lint-js resources/js/**/*",
+        "lint:style": "wp-scripts lint-style resources/scss/**/*.scss"
+    }
+}
diff --git a/lib/payment-gateway/psalm.xml.dist b/lib/payment-gateway/psalm.xml.dist
new file mode 100644
index 00000000..8cf3d706
--- /dev/null
+++ b/lib/payment-gateway/psalm.xml.dist
@@ -0,0 +1,150 @@
+<?xml version="1.0"?>
+<psalm
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xmlns="https://getpsalm.org/schema/config"
+        xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
+        xmlns:xi="http://www.w3.org/2001/XInclude"
+        useDocblockTypes="true"
+        usePhpDocMethodsWithoutMagicCall="false"
+        strictBinaryOperands="true"
+        rememberPropertyAssignmentsAfterCall="true"
+        allowStringToStandInForClass="false"
+        memoizeMethodCallResults="false"
+        hoistConstants="false"
+        addParamDefaultToDocblockType="false"
+        checkForThrowsDocblock="true"
+        checkForThrowsInGlobalScope="false"
+        ignoreInternalFunctionFalseReturn="false"
+        ignoreInternalFunctionNullReturn="false"
+        throwExceptionOnError="false"
+        hideExternalErrors="true"
+        allowFileIncludes="true"
+>
+    <projectFiles>
+        <directory name="src"/>
+    </projectFiles>
+
+    <stubs>
+    	<file name=".psalm/stubs.php"/>
+    	<file name=".psalm/wcblocks.php"/>
+		<file name="vendor/php-stubs/wordpress-stubs/wordpress-stubs.php"/>
+		<file name="vendor/php-stubs/woocommerce-stubs/woocommerce-stubs.php"/>
+    </stubs>
+
+    <issueHandlers>
+        <ConflictingReferenceConstraint errorLevel="error"/>
+        <ContinueOutsideLoop errorLevel="error"/>
+        <DuplicateArrayKey errorLevel="error"/>
+        <DuplicateClass errorLevel="error"/>
+        <DuplicateFunction errorLevel="error"/>
+        <DuplicateMethod errorLevel="error"/>
+        <DuplicateParam errorLevel="error"/>
+        <EmptyArrayAccess errorLevel="error"/>
+        <FalsableReturnStatement errorLevel="error"/>
+        <FalseOperand errorLevel="error"/>
+        <ForbiddenCode errorLevel="error"/>
+        <ForbiddenEcho errorLevel="error"/>
+        <InaccessibleClassConstant errorLevel="error"/>
+        <InaccessibleMethod errorLevel="error"/>
+        <InterfaceInstantiation errorLevel="error"/>
+        <InaccessibleProperty errorLevel="error"/>
+        <InternalClass errorLevel="error"/>
+        <InternalMethod errorLevel="error"/>
+        <InternalProperty errorLevel="error"/>
+        <InvalidArgument errorLevel="error"/>
+        <InvalidArrayAccess errorLevel="error"/>
+        <InvalidArrayAssignment errorLevel="error"/>
+        <InvalidArrayOffset errorLevel="error"/>
+        <InvalidCast errorLevel="error"/>
+        <InvalidCatch errorLevel="error"/>
+        <InvalidClass errorLevel="error"/>
+        <InvalidClone errorLevel="error"/>
+        <InvalidFalsableReturnType errorLevel="error"/>
+        <InvalidThrow errorLevel="error"/>
+        <InvalidToString errorLevel="error"/>
+        <LoopInvalidation errorLevel="error"/>
+        <InvalidNullableReturnType errorLevel="error"/>
+        <LessSpecificReturnType errorLevel="error"/>
+        <InvalidGlobal errorLevel="error"/>
+        <InvalidIterator errorLevel="error"/>
+        <InvalidMethodCall errorLevel="error"/>
+        <InvalidFunctionCall errorLevel="error"/>
+        <ImplicitToStringCast errorLevel="error"/>
+        <ImplementedReturnTypeMismatch errorLevel="error"/>
+        <InvalidParamDefault errorLevel="error"/>
+        <InvalidPassByReference errorLevel="error"/>
+        <InvalidPropertyAssignment errorLevel="error"/>
+        <InvalidPropertyAssignmentValue errorLevel="error"/>
+        <InvalidPropertyFetch errorLevel="error"/>
+        <InvalidReturnStatement errorLevel="error"/>
+        <InvalidReturnType errorLevel="error"/>
+        <InvalidScalarArgument errorLevel="error"/>
+        <InvalidScope errorLevel="error"/>
+        <InvalidStaticInvocation errorLevel="error"/>
+        <MissingConstructor errorLevel="error"/>
+        <MissingDependency errorLevel="error"/>
+        <MissingFile errorLevel="error"/>
+        <MixedArgument errorLevel="error"/>
+        <MoreSpecificImplementedParamType errorLevel="error"/>
+        <MoreSpecificReturnType errorLevel="error"/>
+        <NoValue errorLevel="error"/>
+        <NoInterfaceProperties errorLevel="error"/>
+        <NonStaticSelfCall errorLevel="error"/>
+        <NullableReturnStatement errorLevel="error"/>
+        <NullArgument errorLevel="error"/>
+        <NullArrayAccess errorLevel="error"/>
+        <NullArrayOffset errorLevel="error"/>
+        <NullFunctionCall errorLevel="error"/>
+        <NullIterator errorLevel="error"/>
+        <NullOperand errorLevel="error"/>
+        <NullPropertyAssignment errorLevel="error"/>
+        <NullPropertyFetch errorLevel="error"/>
+        <NullReference errorLevel="error"/>
+        <OverriddenMethodAccess errorLevel="error"/>
+        <OverriddenPropertyAccess errorLevel="error"/>
+        <ParadoxicalCondition errorLevel="error"/>
+        <ParentNotFound errorLevel="error"/>
+        <LessSpecificImplementedReturnType errorLevel="error"/>
+        <MissingParamType errorLevel="error"/>
+        <MissingClosureParamType errorLevel="error"/>
+        <MissingClosureReturnType errorLevel="error"/>
+        <MissingPropertyType errorLevel="error"/>
+        <UndefinedConstant errorLevel="error"/>
+
+        <AssignmentToVoid errorLevel="info"/>
+        <DeprecatedClass errorLevel="info"/>
+        <DeprecatedConstant errorLevel="info"/>
+        <DeprecatedTrait errorLevel="info"/>
+        <DocblockTypeContradiction errorLevel="info"/>
+        <InvalidDocblock errorLevel="info"/>
+        <InvalidDocblockParamName errorLevel="info"/>
+        <InvalidTemplateParam errorLevel="info"/>
+        <DeprecatedInterface errorLevel="info"/>
+        <DeprecatedMethod errorLevel="info"/>
+        <DeprecatedProperty errorLevel="info"/>
+        <MethodSignatureMustOmitReturnType errorLevel="info"/>
+        <MismatchingDocblockParamType errorLevel="info"/>
+        <MismatchingDocblockReturnType errorLevel="info"/>
+        <MissingDocblockType errorLevel="info"/>
+        <MissingParamType errorLevel="info"/>
+        <MissingTemplateParam errorLevel="info"/>
+        <MissingThrowsDocblock errorLevel="info"/>
+        <MixedArgumentTypeCoercion errorLevel="info"/>
+        <MixedArrayAccess errorLevel="info"/>
+        <MixedArrayAssignment errorLevel="info"/>
+        <MixedArrayOffset errorLevel="info"/>
+        <MixedArrayTypeCoercion errorLevel="info"/>
+        <MixedAssignment errorLevel="info"/>
+        <MixedFunctionCall errorLevel="info"/>
+        <MixedInferredReturnType errorLevel="info"/>
+        <MixedMethodCall errorLevel="info"/>
+        <MixedOperand errorLevel="info"/>
+        <MixedPropertyAssignment errorLevel="info"/>
+        <MixedPropertyFetch errorLevel="info"/>
+        <MixedPropertyTypeCoercion errorLevel="info"/>
+        <MixedReturnStatement errorLevel="info"/>
+        <MixedReturnTypeCoercion errorLevel="info"/>
+		<MixedStringOffsetAssignment errorLevel="info"/>
+		<ParamNameMismatch errorLevel="info"/>
+    </issueHandlers>
+</psalm>
diff --git a/lib/payment-gateway/release.config.js b/lib/payment-gateway/release.config.js
new file mode 100644
index 00000000..0ca2a55e
--- /dev/null
+++ b/lib/payment-gateway/release.config.js
@@ -0,0 +1,15 @@
+module.exports = {
+    "branches": ["main"],
+    "plugins": [
+        "@semantic-release/commit-analyzer",
+        "@semantic-release/release-notes-generator",
+        "@semantic-release/changelog",
+        "@semantic-release/github",
+        ["@semantic-release/git", {
+            "assets": ["CHANGELOG.md"],
+            "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+        }]
+    ],
+    "preset": "angular",
+    "tagFormat": "${version}"
+}
\ No newline at end of file
diff --git a/lib/payment-gateway/resources/js/backend.js b/lib/payment-gateway/resources/js/backend.js
new file mode 100644
index 00000000..f5f3a3c6
--- /dev/null
+++ b/lib/payment-gateway/resources/js/backend.js
@@ -0,0 +1 @@
+alert('hi!');
diff --git a/lib/payment-gateway/resources/js/blocks/index.js b/lib/payment-gateway/resources/js/blocks/index.js
new file mode 100644
index 00000000..17c66c7e
--- /dev/null
+++ b/lib/payment-gateway/resources/js/blocks/index.js
@@ -0,0 +1,67 @@
+import {__} from '@wordpress/i18n';
+import {registerPaymentMethod} from '@woocommerce/blocks-registry';
+import {decodeEntities} from '@wordpress/html-entities';
+import {getSetting} from '@woocommerce/settings';
+import {defaultHooks} from '@wordpress/hooks';
+
+
+inpsydeGateways.forEach((name) => {
+    const settings = getSetting(`${name}_data`, {});
+    const hookName = `${name}_checkout_fields`;
+    const defaultLabel = __(
+        'Syde Payment Gateway',
+        'syde-payment-gateway'
+    );
+
+    const label = decodeEntities(settings.title) || defaultLabel;
+
+    const Content = () => {
+        const components = defaultHooks.applyFilters(hookName, [])
+        console.log(hookName)
+
+        /**
+         * If no external plugins/slot-fills are configured,
+         * we default to displaying the method description
+         */
+        if (!Array.isArray(components) || !components.length) {
+            const DefaultPlugin = () => decodeEntities(settings.description || '');
+            return <DefaultPlugin />
+        }
+
+        return (
+            <>{components.map((Component) => <Component />)}</>
+        );
+    };
+    /**
+     * Label component
+     *
+     * @param {*} props Props from payment API.
+     */
+    const Label = (props) => {
+        const {PaymentMethodLabel} = props.components;
+        return <PaymentMethodLabel text={label} />;
+    };
+
+    /**
+     * Payment method config object.
+     */
+    const PaymentMethod = {
+        name: name,
+        label: <Label />,
+        content: <Content />,
+        edit: <Content />,
+        canMakePayment: () => true,
+        ariaLabel: label,
+        supports: {
+            features: settings.supports,
+        },
+    };
+
+    if (settings.placeOrderButtonLabel) {
+        PaymentMethod.placeOrderButtonLabel = settings.placeOrderButtonLabel;
+    }
+
+    registerPaymentMethod(PaymentMethod);
+
+})
+
diff --git a/lib/payment-gateway/src/Fields/ContentField.php b/lib/payment-gateway/src/Fields/ContentField.php
new file mode 100644
index 00000000..1c74d323
--- /dev/null
+++ b/lib/payment-gateway/src/Fields/ContentField.php
@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway\Fields;
+
+use Inpsyde\PaymentGateway\PaymentGateway;
+use Inpsyde\PaymentGateway\SettingsFieldRendererInterface;
+
+/**
+ * The field for rendering basic HTML content.
+ *
+ * Main attributes: title, description.
+ * If title is missing, the description will take the whole row.
+ */
+class ContentField implements SettingsFieldRendererInterface
+{
+    public function render(string $fieldId, array $fieldConfig, PaymentGateway $gateway): string
+    {
+        $fieldKey = $gateway->get_field_key($fieldId);
+        $data = array_merge([
+            'title' => '',
+            'disabled' => false,
+            'class' => '',
+            'css' => '',
+            'placeholder' => '',
+            'type' => 'text',
+            'desc_tip' => false,
+            'description' => '',
+            'custom_attributes' => [],
+        ], $fieldConfig);
+
+        $hasTitle = !empty($data['title']);
+
+        // phpcs:disable WordPress.Security.EscapeOutput.OutputNotEscaped
+        ob_start();
+        ?>
+        <tr valign="top">
+            <?php if ($hasTitle) : ?>
+            <th scope="row" class="titledesc">
+                <label for="<?php echo esc_attr($fieldKey); ?>">
+                    <?php echo wp_kses_post((string) $data['title']); ?>
+                    <?php echo $gateway->get_tooltip_html($data); ?>
+                </label>
+            </th>
+            <?php endif; ?>
+            <td colspan="<?php echo $hasTitle ? '1' : '2'; ?>"
+                style="<?php echo $hasTitle ? '' : 'padding-left: 0;'; ?>">
+                <?php echo $gateway->get_description_html($data); ?>
+            </td>
+        </tr>
+        <?php
+
+        return (string) ob_get_clean();
+    }
+}
diff --git a/lib/payment-gateway/src/GatewayIconsRendererInterface.php b/lib/payment-gateway/src/GatewayIconsRendererInterface.php
new file mode 100644
index 00000000..96e83555
--- /dev/null
+++ b/lib/payment-gateway/src/GatewayIconsRendererInterface.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+interface GatewayIconsRendererInterface
+{
+    /**
+     * Renders gateway icons.
+     *
+     * @return string Rendered HTML.
+     */
+    public function renderIcons(): string;
+}
diff --git a/lib/payment-gateway/src/I18n.php b/lib/payment-gateway/src/I18n.php
new file mode 100644
index 00000000..f447b6df
--- /dev/null
+++ b/lib/payment-gateway/src/I18n.php
@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+use Exception;
+use Psr\Container\ContainerInterface;
+
+class I18n
+{
+    protected ContainerInterface $serviceLocator;
+
+    /**
+     * @var array<string, array<string, string|callable(array):string>>
+     */
+    protected array $messagesGatewayMap = [];
+
+    public function __construct(ContainerInterface $serviceLocator)
+    {
+        $this->serviceLocator = $serviceLocator;
+    }
+
+    /**
+     * @throws Exception
+     */
+    public function translate(string $messageKey, string $gatewayId, array $params = []): string
+    {
+        $messages = $this->messageMap($gatewayId);
+
+        $message = $messages[$messageKey] ?? null;
+
+        if ($message === null) {
+            throw new Exception("Message $messageKey not found.");
+        }
+
+        if (is_callable($message)) {
+            return (string) $message($params);
+        }
+        return (string) $message;
+    }
+
+    protected function messageMap(string $gatewayId): array
+    {
+        if (!isset($this->messagesGatewayMap[$gatewayId])) {
+            $this->messagesGatewayMap[$gatewayId] = array_merge(
+                (array) $this->serviceLocator->get('payment_gateways.i18n.messages'),
+                $this->serviceLocator->has("payment_gateway.$gatewayId.i18n.messages") ?
+                    (array) $this->serviceLocator->get("payment_gateway.$gatewayId.i18n.messages") :
+                    []
+            );
+        }
+
+        return $this->messagesGatewayMap[$gatewayId];
+    }
+}
diff --git a/lib/payment-gateway/src/NoopPaymentProcessor.php b/lib/payment-gateway/src/NoopPaymentProcessor.php
new file mode 100644
index 00000000..e1ecf740
--- /dev/null
+++ b/lib/payment-gateway/src/NoopPaymentProcessor.php
@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+class NoopPaymentProcessor implements PaymentProcessorInterface
+{
+    public function processPayment(\WC_Order $order, PaymentGateway $gateway): array
+    {
+        return [
+            'result' => 'success',
+            'redirect' => $gateway->get_return_url($order),
+        ];
+    }
+}
diff --git a/lib/payment-gateway/src/NoopPaymentRequestValidator.php b/lib/payment-gateway/src/NoopPaymentRequestValidator.php
new file mode 100644
index 00000000..b74625c2
--- /dev/null
+++ b/lib/payment-gateway/src/NoopPaymentRequestValidator.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+class NoopPaymentRequestValidator implements PaymentRequestValidatorInterface
+{
+    public function assertIsValid(\WC_Order $order, PaymentGateway $gateway): void
+    {
+        // TODO: Implement assertIsValid() method.
+    }
+}
diff --git a/lib/payment-gateway/src/NoopRefundProcessor.php b/lib/payment-gateway/src/NoopRefundProcessor.php
new file mode 100644
index 00000000..4a0978b2
--- /dev/null
+++ b/lib/payment-gateway/src/NoopRefundProcessor.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+use WC_Order;
+
+class NoopRefundProcessor implements RefundProcessorInterface
+{
+    public function refundOrderPayment(WC_Order $wcOrder, float $amount, string $reason): void
+    {
+    }
+}
diff --git a/lib/payment-gateway/src/PaymentFieldsRendererInterface.php b/lib/payment-gateway/src/PaymentFieldsRendererInterface.php
new file mode 100644
index 00000000..4ac256be
--- /dev/null
+++ b/lib/payment-gateway/src/PaymentFieldsRendererInterface.php
@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+use Throwable;
+
+interface PaymentFieldsRendererInterface
+{
+    /**
+     * Renders the payment fields.
+     *
+     * @return string Rendered HTML.
+     * @throws Throwable
+     */
+    public function renderFields(): string;
+}
diff --git a/lib/payment-gateway/src/PaymentGateway.php b/lib/payment-gateway/src/PaymentGateway.php
new file mode 100644
index 00000000..4367f909
--- /dev/null
+++ b/lib/payment-gateway/src/PaymentGateway.php
@@ -0,0 +1,619 @@
+<?php
+
+// phpcs:disable PSR1.Methods.CamelCapsMethodName.NotCamelCaps
+// phpcs:disable Inpsyde.CodeQuality.NoAccessors.NoGetter
+// phpcs:disable Inpsyde.CodeQuality.ArgumentTypeDeclaration.NoArgumentType
+// phpcs:disable Inpsyde.CodeQuality.ReturnTypeDeclaration.NoReturnType
+// phpcs:disable Inpsyde.CodeQuality.NestingLevel.High
+// phpcs:disable NeutronStandard.Functions.DisallowCallUserFunc.CallUserFunc
+
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+use Exception;
+use Psr\Container\ContainerExceptionInterface;
+use Psr\Container\ContainerInterface;
+use Psr\Container\NotFoundExceptionInterface;
+use RangeException;
+use RuntimeException;
+use UnexpectedValueException;
+use WC_Order;
+use WC_Payment_Gateway;
+use WP_Error;
+
+/**
+ * Abstract Payment gateway.
+ *
+ * We need to disable rules below for the PaymentGateway class because it
+ * extends WC_Payment_Gateway. We haven't this class in the development
+ * environment, but using stubs instead. These stubs have no methods
+ * parameters defined, so we cannot let psalm know what parameters are expected.
+ * Additionally, WC_Payment_Gateway class and its parent WC_Settings_API are not
+ * well-typed, so it causes a lot of false error reports too.
+ *
+ * @psalm-suppress PropertyNotSetInConstructor
+ * @psalm-suppress InvalidPropertyAssignmentValue
+ * @psalm-suppress MixedOperand
+ * @psalm-suppress MissingParamType
+ * @psalm-suppress MixedArrayOffset
+ * @psalm-suppress MixedArgument
+ */
+class PaymentGateway extends WC_Payment_Gateway
+{
+    protected const TRANSACTION_URL_TEMPLATE_FIELD_NAME = '_transaction_url_template';
+
+    protected ContainerInterface $serviceLocator;
+
+    protected I18n $i18n;
+
+    public function __construct(
+        string $id,
+        ContainerInterface $serviceLocator
+    ) {
+
+        $this->id = $id;
+        $this->serviceLocator = $serviceLocator;
+        $this->supports = $this->locateWithFallback('supports', [
+            'products',
+        ]);
+        $this->i18n = $serviceLocator->get('payment_gateways.i18n');
+        $this->init_settings();
+        unset($this->order_button_text);
+        unset($this->method_title);
+        unset($this->method_description);
+
+        add_action(
+            'woocommerce_update_options_payment_gateways_' . $this->id,
+            [$this, 'process_admin_options']
+        );
+
+        add_action('woocommerce_settings_checkout', [$this, 'display_errors']);
+
+        add_filter(
+            'woocommerce_settings_api_sanitized_fields_' . $this->id,
+            [$this, 'filterVirtualFields'],
+            -1000
+        );
+    }
+
+    public function init_settings()
+    {
+
+        parent::init_settings();
+
+        do_action($this->id . '_after_init_settings', $this);
+    }
+
+    public function get_title(): string
+    {
+        if (!$this->title) {
+            $this->title = $this->locateWithFallback('title', $this->id);
+        }
+
+        return parent::get_title();
+    }
+
+    public function get_description(): string
+    {
+        if (!$this->description) {
+            $this->description = $this->locateWithFallback('description', $this->id);
+        }
+
+        return parent::get_description();
+    }
+
+    /**
+     * Detect payment gateway availability.
+     *
+     * @return bool Whether it is available, true for yes and false for no.
+     */
+    public function is_available(): bool
+    {
+        $isAvailable = parent::is_available();
+
+        if (!$isAvailable) {
+            return false;
+        }
+
+        $canBeUsed = $this->locateWithFallback('availability_callback', static function () {
+            return true;
+        });
+        assert(is_callable($canBeUsed));
+
+        return $canBeUsed($this);
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function process_payment($orderId): array
+    {
+        /**
+         * Produce the WC_Order instance first
+         * This should never fail unless there's a bug in WC
+         * But we need to be verbose here
+         */
+        try {
+            $order = $this->getOrder((string) $orderId);
+            $paymentRequestValidator = $this->locate(
+                'payment_request_validator'
+            );
+            assert($paymentRequestValidator instanceof PaymentRequestValidatorInterface);
+            $paymentRequestValidator->assertIsValid($order, $this);
+        } catch (RuntimeException $exception) {
+            wc_add_notice($exception->getMessage(), 'error');
+            WC()->session->set('refresh_totals', true);
+
+            return [
+                'result' => 'failure',
+                'redirect' => '',
+            ];
+        }
+
+        $processor = $this->locate('payment_processor');
+        assert($processor instanceof PaymentProcessorInterface);
+
+        return $processor->processPayment($order, $this);
+    }
+
+    public function get_icon()
+    {
+        try {
+            $iconService = $this->locate('gateway_icons_renderer');
+            assert($iconService instanceof GatewayIconsRendererInterface);
+        } catch (ContainerExceptionInterface $exception) {
+            return apply_filters('woocommerce_gateway_icon', '', $this->id);
+        }
+
+        $output = $iconService->renderIcons();
+
+        return apply_filters('woocommerce_gateway_icon', $output, $this->id);
+    }
+
+    /**
+     * Get order by ID or throw exception.
+     *
+     * @param string $orderId Order ID to get order by.
+     *
+     * @return WC_Order Found order.
+     *
+     * @throws RuntimeException If order not found.
+     */
+    protected function getOrder(string $orderId): WC_Order
+    {
+        $order = wc_get_order($orderId);
+
+        if (!$order instanceof WC_Order) {
+            throw new RuntimeException(
+                sprintf(
+                    'Failed to process order %1$d, it cannot be found.',
+                    $orderId
+                )
+            );
+        }
+
+        return $order;
+    }
+
+    /**
+     * Get transaction URL template for order.
+     *
+     * @param $order
+     *
+     * @return string
+     */
+    public function get_transaction_url($order): string
+    {
+        $this->view_transaction_url = (string) $order->get_meta(
+            self::TRANSACTION_URL_TEMPLATE_FIELD_NAME,
+            true
+        );
+
+        return parent::get_transaction_url($order);
+    }
+
+    /**
+     * @inheritDoc
+     * @throws Exception
+     */
+    public function process_refund($orderId, $amount = \null, $reason = '')
+    {
+        $order = wc_get_order($orderId);
+
+        if (!$order instanceof WC_Order) {
+            return new WP_Error(
+                'refund_order_not_found',
+                $this->i18n->translate('refund_order_not_found', $this->id, [
+                    'orderId' => $orderId,
+                ])
+            );
+        }
+
+        $amount = floatval($amount);
+
+        $refundProcessor = $this->locate('refund_processor');
+        assert($refundProcessor instanceof RefundProcessorInterface);
+
+        $refundProcessor->refundOrderPayment($order, $amount, $reason);
+
+        return true;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function payment_fields(): void
+    {
+        try {
+            $renderer = $this->locate('payment_fields_renderer');
+            assert($renderer instanceof PaymentFieldsRendererInterface);
+        } catch (ContainerExceptionInterface $exception) {
+            parent::payment_fields();
+            return;
+        }
+
+        try {
+            //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+            echo $renderer->renderFields();
+        } catch (\Throwable $exception) {
+            do_action($this->id . '_payment_fields_failure', [
+                'exception' => $exception,
+            ]);
+            echo esc_html($this->i18n->translate(
+                'payment_method_not_available',
+                $this->id
+            ));
+        }
+    }
+
+    /**
+     * Container-aware re-implementation of the parent method.
+     * It first tries to find a dedicated service and falls back to the original implementation
+     * if none is found.
+     *
+     * @param $formFields
+     * @param $echo
+     *
+     * @return string|void
+     */
+    public function generate_settings_html($formFields = [], $echo = true)
+    {
+        if (empty($formFields)) {
+            $formFields = $this->get_form_fields();
+        }
+
+        $html = '';
+        foreach ($formFields as $key => $value) {
+            $type = $this->get_field_type($value);
+            try {
+                /**
+                 * Check if we have a dedicated renderer in our service container
+                 */
+                $fieldRenderer = $this->locate(
+                    'settings_field_renderer.' . $type
+                );
+                assert($fieldRenderer instanceof SettingsFieldRendererInterface);
+                $html .= $fieldRenderer->render($key, $value, $this);
+            } catch (ContainerExceptionInterface $exception) {
+                /**
+                 * Fallback to WC core implementation
+                 */
+                if (method_exists($this, 'generate_' . $type . '_html')) {
+                    $html .= $this->{'generate_' . $type . '_html'}($key, $value);
+                    continue;
+                }
+                if (has_filter('woocommerce_generate_' . $type . '_html')) {
+                    $html .= apply_filters(
+                        'woocommerce_generate_' . $type . '_html',
+                        '',
+                        $key,
+                        $value,
+                        $this
+                    );
+                    continue;
+                }
+                $html .= $this->generate_text_html($key, $value);
+            }
+        }
+        if ($echo) {
+            // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+            echo $html;
+        }
+
+        return $html;
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * Adds support for groups.
+     */
+    public function get_custom_attribute_html($data)
+    {
+        if (!isset($data['custom_attributes'])) {
+            $data['custom_attributes'] = [];
+        }
+
+        if (isset($data['group'])) {
+            $data['custom_attributes']['group'] = $data['group'];
+        }
+
+        if (isset($data['group_role'])) {
+            $data['custom_attributes']['group_role'] = $data['group_role'];
+        }
+
+        $html = parent::get_custom_attribute_html($data);
+
+        return $html;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function process_admin_options(): bool
+    {
+        $result = parent::process_admin_options();
+
+        return $result;
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * Makes sanitization container-aware.
+     * If a  'inpsyde_payment_gateway.settings_field_sanitizer.' . $type service is found
+     * then it is used instead of WC core sanitization.
+     *
+     * Additional exception handling is applied, so a RangeException thrown by any sanitization
+     * will be rendered as an error
+     */
+    public function get_field_value($key, $field, $postData = [])
+    {
+        $type = $this->get_field_type($field);
+        $fieldKey = $this->get_field_key($key);
+        // phpcs:ignore WordPress.Security
+        $postData = empty($postData) ? $_POST : $postData;
+        $value = $postData[$fieldKey] ?? null;
+        try {
+            if (isset($field['sanitize_callback']) && is_callable($field['sanitize_callback'])) {
+                // keeping WC behavior
+                // phpcs:ignore Inpsyde.CodeQuality.DisableCallUserFunc.call_user_func_call_user_func
+                return call_user_func($field['sanitize_callback'], $value);
+            }
+
+            /**
+             * Check if we have a dedicated field sanitizer in our service container
+             */
+            $sanitizer = $this->locateWithFallback(
+                'settings_field_sanitizer.' . $key . '_field',
+                $this->locateWithFallback('settings_field_sanitizer.' . $type, null)
+            );
+            if ($sanitizer instanceof SettingsFieldSanitizerInterface) {
+                return $sanitizer->sanitize($key, $value, $this);
+            }
+
+            /**
+             * Fallback to WC core implementation
+             */
+            // Look for a validate_FIELDID_field method for special handling.
+            if (is_callable([$this, 'validate_' . $key . '_field'])) {
+                return $this->{'validate_' . $key . '_field'}($key, $value);
+            }
+
+            // Look for a validate_FIELDTYPE_field method.
+            if (is_callable([$this, 'validate_' . $type . '_field'])) {
+                return $this->{'validate_' . $type . '_field'}($key, $value);
+            }
+
+            // Fallback to text.
+            return $this->validate_text_field($key, $value);
+        } catch (RangeException $exception) {
+            $this->add_error(
+                sprintf('Field "%1$s" is invalid: %2$s', $key, $exception->getMessage())
+            );
+
+            return null;
+        }
+    }
+
+    /**
+     * Retrieves configuration for a field.
+     *
+     * @param string $key The key of the field.
+     *
+     * @return array The field configuration.
+     *
+     * @throws RangeException If field not configured.
+     * @throws RuntimeException If problem retrieving.
+     */
+    protected function getFieldConfig(string $key): array
+    {
+        $fields = $this->get_form_fields();
+        if (!isset($fields[$key])) {
+            throw new RangeException(sprintf('Field "%1$s" is not configured', $key));
+        }
+
+        $field = $fields[$key];
+        if (!is_array($field)) {
+            throw new UnexpectedValueException(
+                sprintf('Invalid configuration for field "%1$s"', $key)
+            );
+        }
+
+        return $field;
+    }
+
+    /**
+     * Retrieves the incoming value of a field with the specified name.
+     *
+     * @param string $key The field key.
+     *
+     * @return scalar The value of the field.
+     *
+     * @throws RangeException If field not configured.
+     * @throws RuntimeException If problem retrieving.
+     */
+    protected function getIncomingFieldValue(string $key)
+    {
+        $field = $this->getFieldConfig($key);
+        /**
+         * See https://github.com/woocommerce/woocommerce/issues/32512
+         */
+        $type = $this->get_field_type($field);
+        // Virtual fields only available in storage.
+        $value = $type === 'virtual'
+            ? $this->get_option($key)
+            : $this->get_field_value($key, $field);
+
+        return $value;
+    }
+
+    /**
+     * Returns the value of a field with the specified key.
+     *
+     * Allows defaults to be overridden.
+     *
+     * @param string $key The field key.
+     *
+     * @return scalar The value of the field.
+     *
+     * @throws RangeException If field not configured.
+     * @throws RuntimeException If problem retrieving.
+     */
+    protected function getFieldValue(string $key)
+    {
+        $value = $this->getIncomingFieldValue($key);
+
+        if ($value === '') {
+            $value = $this->get_option($key);
+        }
+
+        return $value;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function get_form_fields()
+    {
+        if (!$this->form_fields) {
+            $this->form_fields = $this->locateWithFallback('form_fields', [
+                'enabled' => [
+                    'title' => 'Enable/Disable',
+                    'type' => 'checkbox',
+                    'label' => 'Enable payment method',
+                    'default' => 'no',
+                ],
+            ]);
+        }
+
+        return parent::get_form_fields();
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function get_option_key()
+    {
+        try {
+            $optionKey = $this->locate('option_key');
+            assert(is_string($optionKey));
+        } catch (ContainerExceptionInterface $exception) {
+            $optionKey = null;
+        }
+
+        return $optionKey ?? parent::get_option_key();
+    }
+
+    /**
+     * Prevents some fields from being saved to the database.
+     *
+     * It filters fields with the 'virtual' field type
+     * and fields with the 'save` attribute set to false.
+     * Such fields can be used for safely transferring API credentials or
+     * other use-cases that require processing user input without storing it as-is
+     *
+     * @param array $settings
+     *
+     * @return array
+     */
+    public function filterVirtualFields(array $settings): array
+    {
+        $validFields = array_filter($this->get_form_fields(), static function (array $fieldConfig) {
+            if (isset($fieldConfig['save'])) {
+                return $fieldConfig['save'] !== false;
+            }
+            return $fieldConfig['type'] !== 'virtual';
+        });
+        $validKeys = array_keys($validFields);
+        foreach ($settings as $key => $value) {
+            if (!in_array($key, $validKeys, true)) {
+                unset($settings[$key]);
+            }
+        }
+
+        return $settings;
+    }
+
+    /**
+     * @param string $key
+     * @return mixed
+     * @throws NotFoundExceptionInterface  No entry was found for this key.
+     * @throws ContainerExceptionInterface Error while retrieving the entry.
+     */
+    private function locate(string $key)
+    {
+        try {
+            return $this->serviceLocator->get($this->createServiceKey($key));
+        } catch (ContainerExceptionInterface $exception) {
+            $globalKey = 'payment_gateways.' . $key;
+            if ($this->serviceLocator->has($globalKey)) {
+                return $this->serviceLocator->get($globalKey);
+            }
+
+            throw $exception;
+        }
+    }
+
+    private function locateWithFallback(string $key, $fallback)
+    {
+        try {
+            return $this->locate($key);
+        } catch (ContainerExceptionInterface $exception) {
+            return $fallback;
+        }
+    }
+
+    private function createServiceKey(string $key): string
+    {
+        return 'payment_gateway.' . $this->id . '.' . $key;
+    }
+
+    public function has_fields()
+    {
+        try {
+            return (bool) $this->locate('has_fields');
+        } catch (ContainerExceptionInterface $exception) {
+            return parent::has_fields();
+        }
+    }
+
+    public function __get($name)
+    {
+        if ($name === 'order_button_text') {
+            return $this->locateWithFallback($name, null);
+        }
+
+        if ($name === 'method_title') {
+            return $this->locateWithFallback($name, $this->id);
+        }
+
+        if ($name === 'method_description') {
+            return $this->locateWithFallback($name, $this->id);
+        }
+
+        return $this->$name;
+    }
+}
diff --git a/lib/payment-gateway/src/PaymentGatewayBlocks.php b/lib/payment-gateway/src/PaymentGatewayBlocks.php
new file mode 100644
index 00000000..243dc38d
--- /dev/null
+++ b/lib/payment-gateway/src/PaymentGatewayBlocks.php
@@ -0,0 +1,112 @@
+<?php
+
+// phpcs:disable PSR1.Methods.CamelCapsMethodName.NotCamelCaps
+// phpcs:disable Inpsyde.CodeQuality.NoAccessors.NoGetter
+// phpcs:disable Inpsyde.CodeQuality.ArgumentTypeDeclaration.NoArgumentType
+// phpcs:disable Inpsyde.CodeQuality.ReturnTypeDeclaration.NoReturnType
+
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+use Automattic\WooCommerce\Blocks\Payments\Integrations\AbstractPaymentMethodType;
+use Psr\Container\ContainerInterface;
+use WC_Payment_Gateways;
+
+class PaymentGatewayBlocks extends AbstractPaymentMethodType
+{
+    private ContainerInterface $container;
+
+    /**
+     * phpcs:disable SlevomatCodingStandard.TypeHints.PropertyTypeHint.MissingNativeTypeHint
+     * @var string
+     */
+    protected $name;
+
+    private ?PaymentGateway $gateway = null;
+
+    public function __construct(ContainerInterface $container, string $gatewayId)
+    {
+        $this->container = $container;
+        $this->name = $gatewayId;
+    }
+
+    public function initialize()
+    {
+        // TODO: Implement initialize() method.
+    }
+
+    public function is_active()
+    {
+        return true;
+    }
+
+    /**
+     * Returns an array of scripts/handles to be registered for this payment method.
+     *
+     * @return array
+     */
+    public function get_payment_method_script_handles()
+    {
+        $scriptPath = '/js/frontend/blocks.js';
+        $scriptAssetPath = $this->container
+                ->get('payment_gateways.assets_path') . '/js/frontend/blocks.asset.php';
+        $scriptAsset = file_exists($scriptAssetPath)
+            ? require($scriptAssetPath)
+            : [
+                'dependencies' => [],
+                'version' => '0.1.0',
+            ];
+        $scriptUrl = $this->container->get('payment_gateways.assets_url') . $scriptPath;
+        $scriptId = 'inpsyde-blocks';
+        /**
+         * @psalm-suppress MixedArgument
+         */
+        wp_register_script(
+            $scriptId,
+            $scriptUrl,
+            $scriptAsset['dependencies'],
+            $scriptAsset['version'],
+            true
+        );
+        /**
+         * @psalm-suppress MixedArgument
+         */
+        wp_localize_script($scriptId, 'inpsydeGateways', $this->container->get('payment_gateways'));
+
+        return [$scriptId];
+    }
+
+    public function get_payment_method_data()
+    {
+        $gateway = $this->gateway();
+
+        return [
+            'title' => $gateway->get_title(),
+            'description' => $gateway->get_description(),
+            'supports' => array_filter($gateway->supports, [$gateway, 'supports']),
+            'placeOrderButtonLabel' => $gateway->order_button_text,
+        ];
+    }
+
+    protected function gateway(): PaymentGateway
+    {
+        if ($this->gateway !== null) {
+            return $this->gateway;
+        }
+
+        $wcPaymentGateways = WC_Payment_Gateways::instance();
+        $gateways = $wcPaymentGateways->payment_gateways();
+        foreach ($gateways as $gatewayId => $gateway) {
+            if ($gatewayId === $this->name) {
+                assert($gateway instanceof PaymentGateway);
+
+                $this->gateway = $gateway;
+
+                return $this->gateway;
+            }
+        }
+        throw new \RuntimeException('Gateway not found');
+    }
+}
diff --git a/lib/payment-gateway/src/PaymentGatewayModule.php b/lib/payment-gateway/src/PaymentGatewayModule.php
new file mode 100644
index 00000000..06b3f743
--- /dev/null
+++ b/lib/payment-gateway/src/PaymentGatewayModule.php
@@ -0,0 +1,192 @@
+<?php
+
+//phpcs:disable Inpsyde.CodeQuality.NestingLevel.High
+//phpcs:disable Inpsyde.CodeQuality.LineLength.TooLong
+//phpcs:disable Inpsyde.CodeQuality.FunctionLength.TooLong
+
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+use Automattic\WooCommerce\Blocks\Payments\Integrations\AbstractPaymentMethodType;
+use Automattic\WooCommerce\Blocks\Payments\PaymentMethodRegistry;
+use Inpsyde\Modularity\Module\ExecutableModule;
+use Inpsyde\Modularity\Module\ModuleClassNameIdTrait;
+use Inpsyde\Modularity\Module\ServiceModule;
+use Inpsyde\PaymentGateway\Fields\ContentField;
+use Psr\Container\ContainerExceptionInterface;
+use Psr\Container\ContainerInterface;
+
+class PaymentGatewayModule implements ServiceModule, ExecutableModule
+{
+    use ModuleClassNameIdTrait;
+
+    public function services(): array
+    {
+        return [
+            'payment_gateways.assets_url' => function (): string {
+                return $this->getPluginFileUrlFromAbsolutePath(dirname(__DIR__) . '/assets');
+            },
+            'payment_gateways.assets_path' => static function (): string {
+                return dirname(__DIR__) . '/assets';
+            },
+            'payment_gateways.noop_payment_request_validator' => static function (): PaymentRequestValidatorInterface {
+                return new NoopPaymentRequestValidator();
+            },
+            'payment_gateways.noop_payment_processor' => static function (): PaymentProcessorInterface {
+                return new NoopPaymentProcessor();
+            },
+            'payment_gateways.noop_refund_processor' => static function (): RefundProcessorInterface {
+                return new NoopRefundProcessor();
+            },
+            'payment_gateways.settings_field_renderer.content' => static function (): SettingsFieldRendererInterface {
+                return new ContentField();
+            },
+            'payment_gateways' => static function (): array {
+                return [];
+            },
+            'payment_gateways.required_services' => static function (): array {
+                return [
+                    'payment_gateway.%s.payment_request_validator',
+                    'payment_gateway.%s.payment_processor',
+                ];
+            },
+            'payment_gateways.validator' => static function (ContainerInterface $container): PaymentGatewayValidator {
+                $requiredServices = $container->get('payment_gateways.required_services');
+                assert(is_array($requiredServices));
+                return new PaymentGatewayValidator($container, $requiredServices);
+            },
+            'payment_gateways.i18n' => static fn (ContainerInterface $container): I18n => new I18n($container),
+            'payment_gateways.i18n.messages' => static fn (): array => [
+                'refund_order_not_found' => static fn (array $params): string => sprintf(
+                    /* translators: %1$s is replaced with the actual order ID. */
+                    __(
+                        'Failed to process the refund: the order with ID %1$s not found',
+                        'syde-payment-gateway'
+                    ),
+                    (string) $params['orderId']
+                ),
+                'refund_failed' => __(
+                    'Failed to refund the order payment',
+                    'syde-payment-gateway'
+                ),
+                'payment_method_not_available' => __(
+                    'Payment method not available. Please select another payment method.',
+                    'syde-payment-gateway'
+                ),
+            ],
+        ];
+    }
+
+    /**
+     * Get the full URL to a file within a plugin, given its absolute file path.
+     *
+     * @param string $absoluteFilePath The absolute path to the file.
+     *
+     * @return string The full URL to the file.
+     * @throws \RuntimeException if not found in active plugins.
+     */
+    private function getPluginFileUrlFromAbsolutePath(string $absoluteFilePath): string
+    {
+        $activePlugins = wp_get_active_and_valid_plugins();
+        $networkPlugins = function_exists('wp_get_active_network_plugins') ?
+            wp_get_active_network_plugins() :
+            [];
+        $plugins = array_merge($activePlugins, $networkPlugins);
+
+        // Iterate through active plugins to find the matching one
+        foreach ($plugins as $plugin) {
+            $pluginPath = \WP_PLUGIN_DIR . '/' . dirname(plugin_basename($plugin));
+            if (0 === strpos($absoluteFilePath, $pluginPath)) {
+                $relativePath = (string) substr($absoluteFilePath, strlen($pluginPath) + 1);
+                $baseUrl = plugins_url('', $plugin);
+                return $baseUrl . '/' . $relativePath;
+            }
+        }
+
+        throw new \RuntimeException('Could not derive plugin path'); // File not found in active plugins
+    }
+
+    public function run(ContainerInterface $container): bool
+    {
+        add_filter('woocommerce_payment_gateways', static function (array $gateways) use ($container) {
+            $gatewayIds = $container->get('payment_gateways');
+            $gatewayValidator = $container->get('payment_gateways.validator');
+            assert($gatewayValidator instanceof PaymentGatewayValidator);
+            foreach ($gatewayIds as $gatewayId) {
+                assert(is_string($gatewayId));
+                if ($gatewayValidator->validate($gatewayId)) {
+                    $gateways[] = new PaymentGateway($gatewayId, $container);
+                }
+            }
+
+            return $gateways;
+        });
+
+        /**
+         * Registers WooCommerce Blocks integration.
+         *
+         */
+        add_action('woocommerce_blocks_loaded', function () use ($container): void {
+            if (!class_exists(AbstractPaymentMethodType::class)) {
+                return;
+            }
+
+            add_action(
+                'woocommerce_blocks_payment_method_type_registration',
+                function (PaymentMethodRegistry $registry) use ($container) {
+                    $gatewayIds = $container->get('payment_gateways');
+                    $gatewayValidator = $container->get('payment_gateways.validator');
+                    assert($gatewayValidator instanceof PaymentGatewayValidator);
+                    foreach ($gatewayIds as $gatewayId) {
+                        assert(is_string($gatewayId));
+                        if (!$gatewayValidator->validate($gatewayId)) {
+                            continue;
+                        }
+                        $this->registerBlocksSupportUnlessDisabled(
+                            $gatewayId,
+                            $container,
+                            $registry
+                        );
+                    }
+                }
+            );
+        });
+
+        return true;
+    }
+
+    /**
+     * Register blocks integration after checking a method-specific key to control whether this method
+     * opts out of the functionality. This might be needed for integrations that do not yet support the
+     * needed JS components but also cannot work with a generic approach.
+     *
+     * @param string $gatewayId
+     * @param ContainerInterface $container
+     * @param PaymentMethodRegistry $registry
+     *
+     * @return void
+     * @throws ContainerExceptionInterface
+     */
+    private function registerBlocksSupportUnlessDisabled(
+        string $gatewayId,
+        ContainerInterface $container,
+        PaymentMethodRegistry $registry
+    ): void {
+
+        $registerBlocksKey = 'payment_gateway.' . $gatewayId . '.register_blocks';
+        $shouldRegister = true;
+
+        if ($container->has($registerBlocksKey)) {
+            $shouldRegister = (bool) $container->get($registerBlocksKey);
+        }
+
+        if (!$shouldRegister) {
+            return;
+        }
+        $registry->register(
+            new PaymentGatewayBlocks($container, $gatewayId)
+        );
+    }
+}
diff --git a/lib/payment-gateway/src/PaymentGatewayValidator.php b/lib/payment-gateway/src/PaymentGatewayValidator.php
new file mode 100644
index 00000000..cb5cc690
--- /dev/null
+++ b/lib/payment-gateway/src/PaymentGatewayValidator.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+use Psr\Container\ContainerInterface;
+
+class PaymentGatewayValidator
+{
+    /** @var string[] */
+    private array $requiredServices;
+
+    private ContainerInterface $container;
+
+    public function __construct(ContainerInterface $container, array $requiredServices)
+    {
+        $this->container = $container;
+        $this->requiredServices = $requiredServices;
+    }
+
+    public function validate(string $gatewayId): bool
+    {
+        /** @var string $requiredService */
+        foreach ($this->requiredServices as $requiredService) {
+            $service = sprintf($requiredService, $gatewayId);
+            if (!$this->container->has($service)) {
+                throw new \Exception(
+                    "Please define a service: '$service' for a gateway with the ID: $gatewayId"
+                );
+            }
+        }
+        return true;
+    }
+}
diff --git a/lib/payment-gateway/src/PaymentProcessorInterface.php b/lib/payment-gateway/src/PaymentProcessorInterface.php
new file mode 100644
index 00000000..dfb27679
--- /dev/null
+++ b/lib/payment-gateway/src/PaymentProcessorInterface.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+interface PaymentProcessorInterface
+{
+    public function processPayment(\WC_Order $order, PaymentGateway $gateway): array;
+}
diff --git a/lib/payment-gateway/src/PaymentRequestValidatorInterface.php b/lib/payment-gateway/src/PaymentRequestValidatorInterface.php
new file mode 100644
index 00000000..9d12ef3d
--- /dev/null
+++ b/lib/payment-gateway/src/PaymentRequestValidatorInterface.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+interface PaymentRequestValidatorInterface
+{
+    /**
+     * @param \WC_Order $order
+     * @param PaymentGateway $gateway
+     * @throws \RuntimeException
+     */
+    public function assertIsValid(\WC_Order $order, PaymentGateway $gateway): void;
+}
diff --git a/lib/payment-gateway/src/RefundProcessorInterface.php b/lib/payment-gateway/src/RefundProcessorInterface.php
new file mode 100644
index 00000000..fc7084bc
--- /dev/null
+++ b/lib/payment-gateway/src/RefundProcessorInterface.php
@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+use Exception;
+use WC_Order;
+
+interface RefundProcessorInterface
+{
+    /**
+     * @throws Exception If failed to refund payment.
+     */
+    public function refundOrderPayment(
+        WC_Order $wcOrder,
+        float $amount,
+        string $reason
+    ): void;
+}
diff --git a/lib/payment-gateway/src/SettingsFieldRendererInterface.php b/lib/payment-gateway/src/SettingsFieldRendererInterface.php
new file mode 100644
index 00000000..db21aea5
--- /dev/null
+++ b/lib/payment-gateway/src/SettingsFieldRendererInterface.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+interface SettingsFieldRendererInterface
+{
+    public function render(string $fieldId, array $fieldConfig, PaymentGateway $gateway): string;
+}
diff --git a/lib/payment-gateway/src/SettingsFieldSanitizerInterface.php b/lib/payment-gateway/src/SettingsFieldSanitizerInterface.php
new file mode 100644
index 00000000..8361f0a3
--- /dev/null
+++ b/lib/payment-gateway/src/SettingsFieldSanitizerInterface.php
@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inpsyde\PaymentGateway;
+
+use RangeException;
+
+/**
+ * @psalm-suppress MissingParamType
+ */
+interface SettingsFieldSanitizerInterface
+{
+    /**
+     * @param string $key
+     * @param mixed $value
+     * @param PaymentGateway $gateway
+     *
+     * @return mixed
+     * @throws RangeException
+     */
+    public function sanitize(string $key, $value, PaymentGateway $gateway);
+}
diff --git a/lib/payment-gateway/webpack.config.js b/lib/payment-gateway/webpack.config.js
new file mode 100644
index 00000000..8552db91
--- /dev/null
+++ b/lib/payment-gateway/webpack.config.js
@@ -0,0 +1,47 @@
+const defaultConfig = require('@wordpress/scripts/config/webpack.config');
+const WooCommerceDependencyExtractionWebpackPlugin = require('@woocommerce/dependency-extraction-webpack-plugin');
+
+const wcDepMap = {
+    '@woocommerce/blocks-registry': ['wc', 'wcBlocksRegistry'],
+    '@woocommerce/settings'       : ['wc', 'wcSettings']
+};
+
+const wcHandleMap = {
+    '@woocommerce/blocks-registry': 'wc-blocks-registry',
+    '@woocommerce/settings'       : 'wc-settings'
+};
+
+const requestToExternal = (request) => {
+    if (wcDepMap[request]) {
+        return wcDepMap[request];
+    }
+};
+
+const requestToHandle = (request) => {
+    if (wcHandleMap[request]) {
+        return wcHandleMap[request];
+    }
+};
+
+module.exports = {
+    ...defaultConfig,
+    entry: {
+        'frontend/blocks': './resources/js/blocks/index',
+        'backend': './resources/js/backend',
+    },
+    output: {
+        publicPath: './',
+        path: __dirname + '/assets/js',
+        filename: '[name].js',
+    },
+    plugins: [
+        ...defaultConfig.plugins.filter(
+            (plugin) =>
+                plugin.constructor.name !== 'DependencyExtractionWebpackPlugin'
+        ),
+        new WooCommerceDependencyExtractionWebpackPlugin({
+            requestToExternal,
+            requestToHandle
+        })
+    ]
+};