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, Google Pay y SEPA Direct Debit.

Antes de empezar

Para probar tu integración:

• Usa tu clave de API del modo de prueba. Puedes encontrarla en MONEI Dashboard → Settings → API Access.
• Puedes comprobar el estado de un pago de prueba en MONEI Dashboard → Payments (en modo de prueba).

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 → Settings → API Access	Sí
MONEI_ACCOUNT_ID	Tu Account ID de MONEI en Dashboard → Settings → API Access	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 → Settings → Webhooks
2. Añade un nuevo endpoint de webhook con la URL proporcionada tras desplegar el conector
3. Copia la clave de firma HMAC 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
SEPA Direct Debit	Pagos por débito bancario directo en la zona SEPA

Para activar los métodos de pago, configúralos en MONEI Dashboard → Settings → Payment Methods 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 captura, el reembolso y la cancelación