Skip to content

Install the module

Install in a staging copy first. Back up the shop's database, files and Composer lock file. Run commands as the Magento filesystem owner, using the PHP version and deployment process for that shop. Keep existing maintenance, cron and worker procedures under your hosting deployment process.

The commands below run from the Magento project root. Replace the locale examples with the languages deployed by your shop. For a production change, enable maintenance before modifying the installation and disable it only after successful checks.

Composer installation

  1. Sign in to the mame account that owns the license and open Downloads > TWINT for Magento 2 > Installation & updates.
  2. Select the Standard/Luma installation. Create Composer access using a current owned module license. Copy the one-time password to your password manager; it is separate from Magento's payment API credentials.
  3. Configure the repository and install the core package:
composer config repositories.mame composer https://mamedev.ch/api/composer/magento
composer require mamedev/module-twint

Composer requests HTTP Basic credentials when required. Use the username/password issued by Downloads. Keep authentication in an untracked auth.json or your deployment secret store; do not put a password in a shared command, screenshot or Git repository. Revocation, expiry or transfer can remove access to future metadata and downloads. Existing local files and Composer caches are not remotely deleted.

  1. Enable and deploy the module:
php bin/magento module:enable Mame_Twint
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f de_CH en_US
php bin/magento cache:flush
php bin/magento module:status Mame_Twint

Composer selects a compatible registered version and records it in composer.lock. Keep the lock file in the shop's normal deployment workflow. Complete the Website connection after installation.

ZIP installation

  1. Download the core ZIP from the owning account's Downloads page. Only use an entitled, verified package.
  2. Extract the archive outside the public web root. Place the contents of module-twint/ in app/code/Mame/Twint/. The resulting path must contain app/code/Mame/Twint/registration.php, rather than an additional nested module-twint directory.
  3. Run the enable/deployment commands above.

Choose either Composer or the app/code copy for each module. Do not leave the same module installed in both places. When changing installation method, follow a reviewed deployment plan and retain the module's database records and configuration.

Hyvä Theme

Install and configure the separately licensed Hyvä Theme first, including its required GraphQL modules. Use Hyvä's official installation guide for the theme itself.

Add the TWINT Theme companion:

composer require mamedev/module-twint mamedev/module-twint-hyva
php bin/magento module:enable Mame_Twint Mame_TwintHyva
php bin/magento setup:upgrade
php bin/magento hyva:config:generate

Rebuild your active child theme's Tailwind CSS using that theme's supported Node version and scripts. For a theme with build-prod:

HYVA_TAILWIND_DIR=/absolute/path/to/your/child-theme/web/tailwind
npm --prefix "$HYVA_TAILWIND_DIR" ci
npm --prefix "$HYVA_TAILWIND_DIR" run build-prod

Then run Magento DI compilation, static deployment and cache refresh. The directory must refer to the actual theme used by the Website. Building an unrelated parent theme does not update your child theme.

Hyvä Checkout

Install and license Hyvä Checkout separately using Hyvä's Checkout guide. The qualified TWINT integration uses Checkout 3.0.2 and its Magewire 3 dependencies.

composer require mamedev/module-twint mamedev/module-twint-hyva mamedev/module-twint-hyva-checkout
php bin/magento module:enable Mame_Twint Mame_TwintHyva Mame_TwintHyvaCheckout
php bin/magento setup:upgrade
php bin/magento hyva:config:generate

Rebuild the active theme's Tailwind CSS, then run DI compilation, static deployment and cache refresh. The Checkout companion includes the Theme companion as a dependency. Enable Hyvä Checkout for the intended Website/Store View through Hyvä's normal configuration.

For ZIP deployments, install the Theme archive contents in app/code/Mame/TwintHyva/ and the Checkout archive contents in app/code/Mame/TwintHyvaCheckout/. Deploy the licensed Hyvä dependencies separately. Do not enable a companion when its required Hyvä runtime is absent.

Check the compatibility table and test both ordinary checkout and all enabled Express placements before production use.