commercetools

To accept payments through MONEI in your commercetools Composable Commerce project, install the MONEI payment connector from the Connect marketplace. The connector supports Bizum, card payments, Apple Pay, Google Pay, and SEPA Direct Debit.

Before you begin

To test your integration:

• Use your test mode API Key. You can find it in MONEI Dashboard → Settings → API Access.
• You can check the status of a test payment in your MONEI Dashboard → Payments (in test mode).

You will also need:

• A commercetools Composable Commerce project
• An API Client with the following scopes: manage_payments, manage_orders, view_sessions, view_api_clients, manage_checkout_payment_intents, introspect_oauth_tokens, manage_types, view_types

Install

1. In the commercetools Merchant Center, go to Connect → Marketplace
2. Search for MONEI
3. Click Install on the MONEI Payment Connector
4. Select the Region where your commercetools project is hosted (e.g., europe-west1.gcp)

Alternatively, you can deploy the connector directly from the GitHub repository using the commercetools Connect CLI.

Configure

After installing the connector, configure it with your MONEI credentials:

Variable	Description	Required
MONEI_API_KEY	Your MONEI API Key from Dashboard → Settings → API Access	Yes
MONEI_ACCOUNT_ID	Your MONEI Account ID from Dashboard → Settings → API Access	Yes
MONEI_WEBHOOK_SECRET	Webhook signing secret for verifying notifications	Yes
MONEI_ENVIRONMENT	test or live	Yes
MONEI_PAYMENT_METHODS_ENABLED	Comma-separated list of payment methods to enable (e.g., bizum,card,applePay,googlePay)	No

tip

Start with MONEI_ENVIRONMENT=test and switch to live only after you have verified your integration.

Configure webhooks

The connector automatically handles webhook notifications from MONEI. To set up webhooks:

1. Go to MONEI Dashboard → Settings → Webhooks
2. Add a new webhook endpoint with the URL provided after deploying the connector
3. Copy the generated HMAC signing key and set it as MONEI_WEBHOOK_SECRET in your connector configuration

Supported payment methods

Method	Description
Card	Visa, Mastercard, and other card networks via multi-acquirer routing
Bizum	Spain's mobile payment method with 28M+ users
Apple Pay	Digital wallet payments on Safari and iOS devices
Google Pay	Digital wallet payments on supported browsers
SEPA Direct Debit	Bank direct debit payments across the SEPA zone

To enable payment methods, configure them in your MONEI Dashboard → Settings → Payment Methods and include them in the MONEI_PAYMENT_METHODS_ENABLED connector variable.

Using with commercetools Checkout

The MONEI connector is fully compatible with commercetools Checkout. Once installed:

1. Go to Merchant Center → Checkout → Applications
2. Add a new application or edit an existing one
3. Select the MONEI connector for your payment integrations
4. Choose which payment methods to display and configure their order

The connector supports both web components (individual payment method UI) and drop-in (all methods in one component) integration types.

Before you go live

• Make sure that you are using live (production) mode API Key
• Make sure that you have at least one active payment method
• Update the MONEI_ENVIRONMENT connector variable to live
• Verify that webhooks are correctly configured and receiving notifications
• Test the full payment flow including capture, refund, and cancellation