# 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](https://docs.commercetools.com/connect/connectors). El conector admite Bizum, pagos con tarjeta, Apple Pay, Google Pay y SEPA Direct Debit.

## Antes de empezar[​](#antes-de-empezar "Enlace directo al Antes de empezar")

Para probar tu integración:

* Usa tu clave de API del [modo de prueba](https://docs.monei.com/es/es/testing/.md). Puedes encontrarla en [MONEI Dashboard → Settings → API Access](https://dashboard.monei.com/settings/api).
* Puedes comprobar el estado de un pago de prueba en [MONEI Dashboard → Payments](https://dashboard.monei.com/payments) (en modo de prueba).

También necesitarás:

* Un proyecto de [commercetools Composable Commerce](https://commercetools.com)
* Un [API Client](https://docs.commercetools.com/merchant-center/developer-settings#api-clients) 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[​](#instalar "Enlace directo al Instalar")

1. En el [commercetools Merchant Center](https://mc.commercetools.com), 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](https://github.com/MONEI/connect-payment-integration-monei) usando el [Connect CLI](https://docs.commercetools.com/connect/cli) de commercetools.

## Configurar[​](#configurar "Enlace directo al 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](https://dashboard.monei.com/settings/api) | Sí        |
| **MONEI\_ACCOUNT\_ID**               | Tu Account ID de MONEI en [Dashboard → Settings → API Access](https://dashboard.monei.com/settings/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[​](#configurar-webhooks "Enlace directo al Configurar webhooks")

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

1. Ve a [MONEI Dashboard → Settings → Webhooks](https://dashboard.monei.com/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étodos-de-pago-admitidos "Enlace directo al 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](https://dashboard.monei.com/settings/payment-methods) e inclúyelos en la variable `MONEI_PAYMENT_METHODS_ENABLED` del conector.

## Uso con commercetools Checkout[​](#uso-con-commercetools-checkout "Enlace directo al Uso con commercetools Checkout")

El conector MONEI es totalmente compatible con [commercetools Checkout](https://docs.commercetools.com/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[​](#antes-de-pasar-a-producción "Enlace directo al Antes de pasar a producción")

* Asegúrate de usar la clave de API del [modo en vivo (producción)](https://docs.monei.com/es/es/testing/.md)
* Asegúrate de tener al menos un [método de pago](https://dashboard.monei.com/settings/payment-methods) 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