commercetools

Para aceptar pagos a través de MONEI en tu proyecto commercetools Composable Commerce, instala el conector de pagos MONEI desde el marketplace de Connect. El conector admite Bizum, pagos con tarjeta, Apple Pay y Google Pay.

Antes de empezar

Para probar tu integración:

• Usa tu clave de API del modo de prueba. Puedes encontrarla en MONEI Dashboard → Configuración → Acceso a API.
• Puedes comprobar el estado de un pago de prueba en MONEI Dashboard → Payments (en modo de prueba).

Página Acceso a API en los ajustes del panel de MONEI, con tu ID de cuenta y tu clave API

También necesitarás:

• Un proyecto de commercetools Composable Commerce
• Un API Client con los siguientes permisos: manage_payments, manage_orders, view_sessions, view_api_clients, manage_checkout_payment_intents, introspect_oauth_tokens, manage_types, view_types

Instalar

1. En el commercetools Merchant Center, ve a Connect → Marketplace
2. Busca MONEI
3. Haz clic en Install en el MONEI Payment Connector
4. Selecciona la Region donde está alojado tu proyecto de commercetools (p. ej., europe-west1.gcp)

Alternativamente, puedes desplegar el conector directamente desde el repositorio de GitHub usando el Connect CLI de commercetools.

Configurar

Después de instalar el conector, configúralo con tus credenciales de MONEI:

Variable	Descripción	Requerida
MONEI_API_KEY	Tu clave de API de MONEI en Dashboard → Configuración → Acceso a API	Sí
MONEI_ACCOUNT_ID	Tu Account ID de MONEI en Dashboard → Configuración → Acceso a API	Sí
MONEI_WEBHOOK_SECRET	Clave secreta de firma de webhook para verificar notificaciones	Sí
MONEI_ENVIRONMENT	test o live	Sí
MONEI_PAYMENT_METHODS_ENABLED	Lista separada por comas de los métodos de pago a activar (p. ej., bizum,card,applePay,googlePay)	No

tip

Empieza con MONEI_ENVIRONMENT=test y cambia a live solo después de haber verificado tu integración.

Configurar webhooks

El conector gestiona automáticamente las notificaciones de webhook de MONEI. Para configurar los webhooks:

1. Ve a MONEI Dashboard → Configuración → Webhooks
2. Añade un nuevo endpoint de webhook con la URL proporcionada tras desplegar el conector
3. Copia la clave de firma generada y establécela como MONEI_WEBHOOK_SECRET en la configuración de tu conector

Métodos de pago admitidos

Método	Descripción
Card	Visa, Mastercard y otras redes de tarjetas mediante enrutamiento multi-adquirente
Bizum	Método de pago móvil de España con más de 28 millones de usuarios
Apple Pay	Pagos con monedero digital en Safari y dispositivos iOS
Google Pay	Pagos con monedero digital en navegadores compatibles

Para activar los métodos de pago, configúralos en MONEI Dashboard → Configuración → Métodos de pago e inclúyelos en la variable MONEI_PAYMENT_METHODS_ENABLED del conector.

Uso con commercetools Checkout

El conector MONEI es totalmente compatible con commercetools Checkout. Una vez instalado:

1. Ve a Merchant Center → Checkout → Applications
2. Añade una nueva aplicación o edita una existente
3. Selecciona el conector MONEI para tus integraciones de pago
4. Elige qué métodos de pago mostrar y configura su orden

El conector admite los tipos de integración web components (interfaz de método de pago individual) y drop-in (todos los métodos en un solo componente).

Antes de pasar a producción

• Asegúrate de usar la clave de API del modo en vivo (producción)
• Asegúrate de tener al menos un método de pago activo
• Actualiza la variable MONEI_ENVIRONMENT del conector a live
• Verifica que los webhooks estén correctamente configurados y recibiendo notificaciones
• Prueba el flujo de pago completo, incluida la , el reembolso y la cancelación