Drupal

Available for Drupal 9.x and 10.x

General Information

Drupal is a modular open-source content management system (CMS) that allows businesses to create and manage websites. Through the integration of Payrexx into Drupal, merchants can accept payments from their customers directly in their online store.

Links

• Drupal Website

• Download the Plugin

• Plugin Installation Guide

Setup

Follow the instructions below to integrate Payrexx into Drupal.

Configuration of Payrexx

Make sure you're logged in to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can register now.

• In the merchant administration of your Payrexx account, navigate to API & Plugins.

• Click "Show all" under "Add E-commerce integration".

• Click "Add" next to Drupal:

Starting the integration of Payrexx and Drupal

• In the window below, configure the following settings:

Configuring the Payrexx integration for Drupal

1. API Key: Copy the displayed API key to your clipboard — you will need it later.

2. Instance Name: Copy the displayed instance name to your clipboard — you will also need this later.

3. Enter shop address: Enter the URL of your shop in this field. If your shop is not located in the root directory (e.g., https://demo-shop.com), but in a subdirectory, please enter the full path to your shop. Example: https://demo-shop.com/shop

Make sure the shop URL is entered correctly. Inconsistencies (e.g., using http:// instead of https://) may cause errors in webhook processing.

1. Webhooks: Define whether a failed webhook should be retried or not. If the checkbox is enabled, the system will attempt to resend the webhook up to 10 times. Retry intervals are: 5 minutes, 15 minutes, 1 hour, 2 hours, 4 hours, and then every 24 hours thereafter.

2. Finalize: Click the green "Activate" button to complete the configuration.

Plugin installation

• Install the module by running the following command: composer require drupal/commerce_payrexx_integration

• Activate the module with the command: drush en commerce_payrexx_integration

Module configuration

• Create the payment gateway under /admin/commerce/config/payment-gateways

• Select "Payrexx (Redirect to Payrexx)" as the plugin.

• Fill in all required fields. Insert the values you previously copied during the Payrexx configuration into the corresponding fields:

  • Paste the instance name into the "Instance Name" field.

  • Paste the API key into the "Secret" field.

The configuration is now complete. Your customers can now pay in your Drupal shop using the payment methods available via Payrexx.