Tutorial

Cumplimiento y normativa

Integración CMI: pagos en dírhams en su tienda online

Cuando una agencia construye un sitio de e-commerce para un cliente marroquí, la elección de la pasarela de pago no es un detalle menor: el pago con tarjeta bancaria marroquí se apoya en la plataforma técnica del Centre Monétique Interbancaire (CMI), durante mucho tiempo casi el único adquirente de pagos con tarjeta en Marruecos. No ofrecer este pago equivale a cerrar la puerta a la gran mayoría de los compradores locales y a exponerlos a gastos de cambio en cada transacción. Este artículo detalla lo que la integración de CMI exige del lado del comercio, las restricciones técnicas que hay que anticipar del lado del alojamiento, y por qué SSL, HTTPS y facturación en dírhams forman la base común de todo proyecto de e-commerce marroquí.

13 min de lectura6 pasos
Contenido· Por qué CMI sigue siendo central para el e-commerce marroquí1/12
  1. 01Por qué CMI sigue siendo central para el e-commerce marroquí
  2. 02Lo que CMI aporta concretamente a su cliente comerciante
  3. 03Condiciones de afiliación del comercio: lo que exige el adquirente
  4. 04Expediente de afiliación de comercio CMI — los documentos requeridos
  5. 05Requisitos técnicos: lo que CMI impone al proveedor de alojamiento
  6. 06Verificar la cadena SSL antes de presentar el expediente
  7. 07Protocolos de integración de CMI: página de pago alojada y 3D Secure
  8. 08Gastos de cambio evitados: el caso del dírham marroquí
  9. 09Papel del alojamiento en la integración de CMI
  10. 10Comparativa: PayPal, tarjeta internacional y CMI para un comprador marroquí
  11. 11Resolución de problemas: errores frecuentes en la integración de CMI
  12. 12Para ir más lejos: conformidad e infraestructura para su actividad en Marruecos

Por qué CMI sigue siendo central para el e-commerce marroquí

El Centre Monétique Interbancaire se fundó en 2004 por iniciativa de nueve bancos marroquíes, que son sus accionistas. Los grandes bancos del país — Attijariwafa Bank, CIH, Bank of Africa, BCP, Saham Bank (antes Société Générale Maroc), Crédit Agricole du Maroc, BMCI y otros — emiten tarjetas Visa y Mastercard aceptadas en esta red. El CMI fue durante mucho tiempo casi el único adquirente de pagos con tarjeta en Marruecos; ya no es así. Mediante su decisión n.º 152/D/2024 del 31 de octubre de 2024, el Conseil de la concurrence (Consejo de la Competencia) hizo vinculantes sus compromisos: desde noviembre de 2024, el CMI ya no firma nuevos contratos con comercios; desde mayo de 2025, entidades de pago y filiales bancarias autorizadas comercializan la adquirencia; el CMI se convierte en una plataforma técnica de procesamiento abierta a esos adquirentes.

Un sitio de e-commerce que solo acepta PayPal o una tarjeta internacional excluye de hecho a la inmensa mayoría de los compradores marroquíes: sus tarjetas bancarias pasan por la red CMI, y un pago en divisa extranjera genera gastos de cambio a su cargo. La objeción habitual — «con PayPal basta» — ignora que la adopción de PayPal sigue siendo baja entre los particulares marroquíes, y que los gastos de cambio en cada compra suponen un freno real a la decisión de compra. CMI procesa transacciones en dírham marroquí (MAD), directamente desde la cuenta bancaria del comprador, sin conversión y sin fricción.

Lo que CMI aporta concretamente a su cliente comerciante

  • Aceptación de la tarjeta nacional — todas las tarjetas Visa y Mastercard emitidas por los bancos marroquíes miembros de la red CMI se aceptan de pleno derecho.
  • Transacciones en dírham — ningún freno ligado al tipo de cambio, ni para el comprador ni para el comercio, que cobra directamente en MAD.
  • 3D Secure incluido — el comprador valida su pago con un código secreto enviado por su banco, lo que reduce el fraude y traslada la responsabilidad al banco emisor en caso de litigio.
  • Liquidación en dírhams — el importe neto de las ventas se abona en la cuenta bancaria del comercio en el plazo previsto por su contrato de adquirencia.
  • Aceptación de tarjetas internacionales — las tarjetas Visa y Mastercard emitidas en el extranjero pasan por la misma integración; las demás redes dependen del contrato firmado con el adquirente.
  • Área de comercio en línea — panel de seguimiento de transacciones, extractos de comisiones e historial de operaciones, proporcionados por el adquirente.
  • Soporte en producción — un soporte localizable para las incidencias, cuyos datos de contacto figuran en el contrato de adquirencia.
  • Página de pago en el idioma del comprador — árabe, francés o inglés, elegido por el sitio del comercio en el momento de la redirección.

Condiciones de afiliación del comercio: lo que exige el adquirente

La afiliación ya no se obtiene ante el CMI: desde noviembre de 2024, ya no firma nuevos contratos con comercios. El comercio abre una cuenta profesional en un banco marroquí y después presenta un expediente de afiliación como comercio electrónico ante un adquirente autorizado — entidad de pago o filial bancaria dedicada a la adquirencia —, que su banco puede presentarle.

Se aceptan dos perfiles: las personas jurídicas (sociedades constituidas) y las personas físicas que ejercen una actividad comercial. Los documentos a aportar varían según el estatuto, pero el principio es el mismo en ambos casos: demostrar la existencia legal de la actividad y la capacidad del firmante.

Una condición previa suele subestimarse: el sitio debe estar en línea y plenamente funcional en el momento de la solicitud. El adquirente revisa el sitio antes de validar la afiliación. Un sitio en construcción o servido en HTTP simple será rechazado.

Expediente de afiliación de comercio CMI — los documentos requeridos

  1. Estatutos de la sociedad y poderes del firmante (personas jurídicas)

    Aportar los estatutos constitutivos actualizados, el acta de nombramiento del representante legal y, si el firmante no es el administrador, una delegación de poderes explícita. Las personas físicas aportan en su lugar los justificantes de inscripción de su actividad.

  2. Registro mercantil

    Extracto reciente del registro mercantil marroquí. Para una SARL o una SA, basta con el extracto del tribunal de comercio. La actividad declarada debe corresponder a la que se ejerce en el sitio.

  3. Patente (impuesto profesional)

    Aviso de impuesto profesional en vigor. Este documento lo exige el adquirente para confirmar el arraigo fiscal marroquí de la actividad.

  4. Espécimen de cheque

    Un cheque cruzado de la cuenta bancaria profesional en la que se abonarán las liquidaciones. Esta cuenta debe estar abierta en un banco marroquí.

  5. Documento de identidad del directivo firmante

    Tarjeta Nacional de Identidad (CIN) o pasaporte en vigor del representante legal o del firmante delegado.

  6. URL del sitio de e-commerce

    La dirección completa del sitio, accesible públicamente en HTTPS. El adquirente revisa el sitio antes de la validación: la página de pago debe ser accesible, el certificado SSL válido y el aviso legal presente.

Requisitos técnicos: lo que CMI impone al proveedor de alojamiento

La integración de la pasarela CMI impone restricciones del lado del servidor que el alojamiento debe satisfacer incluso antes de escribir una línea de código de pago. Estos requisitos no son recomendaciones: un sitio que no los cumple será rechazado en la afiliación o verá fallar sus transacciones en producción.

HTTPS obligatorio en todo el sitio. El CMI exige un certificado SSL válido y activo en el dominio del comercio. Las páginas de pago, pero también las páginas de notificación (callback), deben servirse exclusivamente en HTTPS. Un certificado autofirmado o caducado provoca el fallo inmediato de la validación de la afiliación.

URL de notificación (callback) accesible desde el exterior. El servidor de CMI envía una notificación HTTP POST a la URL de callback transmitida con la transacción para confirmar cada transacción. Esta URL debe ser accesible desde los servidores de CMI en todo momento, sin filtrado de IP en el cortafuegos, y responder en un plazo razonable. Un alojamiento detrás de una red privada sin regla de NAT entrante, o un servidor cuyo puerto 443 esté filtrado, bloquea estas notificaciones y deja los pedidos en estado «en espera» del lado del comercio.

Resolución DNS estable. El nombre de dominio del sitio y de la URL de callback debe resolverse correctamente y de forma estable. Una propagación DNS incompleta durante el lanzamiento o un cambio de proveedor de alojamiento sin plazo de transición puede provocar fallos de notificación.

Soporte de 3D Secure. El protocolo 3D Secure (Visa Secure / Mastercard Identity Check) está activado por defecto en la red CMI. El comprador es redirigido a la página de autenticación de su banco y después devuelto a la URL de retorno del comercio. El alojamiento debe permitir estas redirecciones y no bloquear los agentes de usuario ni las IP de los servidores de CMI en las reglas de seguridad de la aplicación.

Verificar la cadena SSL antes de presentar el expediente

El adquirente inspecciona el certificado SSL del sitio en el momento de la afiliación. Un certificado válido a ojos del navegador puede estar incompleto del lado del servidor: si la cadena de autoridad intermedia no la envía el servidor (bundle ausente), algunos verificadores automatizados la señalan como inválida. Antes de presentar el expediente, pruebe la URL con una herramienta en línea como SSL Labs de Qualys: una nota A o A+ indica una cadena completa y un protocolo actualizado (TLS 1.2 como mínimo, TLS 1.3 preferible). Un alojamiento que incluye el certificado SSL en su plan y lo activa por defecto evita esta etapa de verificación manual.

Protocolos de integración de CMI: página de pago alojada y 3D Secure

El CMI ofrece dos protocolos de integración principales para los sitios de e-commerce.

La página de pago alojada (modo 3D_PAY_HOSTING) es el método de integración estándar. El comercio redirige al comprador a la página de pago alojada por el CMI (alojamiento en CMI de la página de introducción de los datos de tarjeta), lo que exime al sitio del comercio de gestionar directamente los datos de tarjeta y simplifica el cumplimiento de PCI-DSS. Los parámetros de la transacción (importe, divisa, referencia del pedido, URL de retorno, URL de callback) se transmiten en un formulario HTML firmado con una clave compartida. El servidor de CMI valida la firma, muestra la página de pago y después notifica al comercio por POST en su URL de callback.

3D Secure está activado por defecto en las transacciones CMI. Durante el pago, el comprador es redirigido a la página ACS (Access Control Server) de su banco, que le envía un código de validación. Este mecanismo transfiere la responsabilidad del fraude al banco emisor siempre que la autenticación se complete — una ventaja operativa directa para el comercio en caso de litigio.

En ambos casos, la URL de callback debe ser absoluta, en HTTPS y accesible desde la internet pública. Evite las URL con IP desnuda y los puertos no estándar: sirva la callback en un nombre de dominio, en HTTPS por el puerto 443.

Gastos de cambio evitados: el caso del dírham marroquí

La facturación en dírham es un punto que se descuida a menudo en los pliegos de condiciones de e-commerce. Cuando un comprador marroquí paga en un sitio que factura en euros o en dólares, su banco aplica un tipo de cambio y puede añadir una comisión de conversión. Este sobrecoste, variable según el banco y el tipo de tarjeta, es visible en el extracto bancario del comprador y constituye un freno psicológico a la compra, en particular para cestas de bajo valor.

Las transacciones CMI están denominadas en dírham marroquí (MAD). El comprador ve el importe exacto de su pedido en dírhams, sin sorpresas de conversión. El comercio recibe la liquidación en dírhams en su cuenta profesional marroquí. Ninguna de las dos partes soporta gastos de cambio.

Para las agencias que gestionan clientes cuya audiencia es mayoritariamente marroquí, es un argumento comercial directo: una integración de CMI en el embudo de compra mejora la tasa de conversión sobre esa audiencia, sin modificar el contenido del sitio.

Papel del alojamiento en la integración de CMI

Los tres requisitos técnicos del CMI — HTTPS activo, URL de callback accesible públicamente, resolución DNS estable — dependen directamente de la elección del proveedor de alojamiento.

Un alojamiento que incluye el certificado SSL en su plan (emisión y renovación automáticas mediante Let's Encrypt o una autoridad equivalente) evita la principal causa de fallo en la afiliación: un certificado caducado o una cadena incompleta. La activación de HTTPS desde la puesta en línea del sitio, incluso antes de presentar el expediente del comercio, es la secuencia que evita las idas y venidas con el banco.

La facturación en dírhams del lado del alojamiento es una ventaja complementaria para las agencias que gestionan varios clientes marroquíes: pagar la infraestructura en MAD, recibir facturas en MAD con IVA marroquí e integrar una pasarela CMI en los sitios entregados forman un conjunto coherente en la contabilidad del cliente. Una agencia que aloja a sus clientes de e-commerce en un plan que incluye SSL, HTTPS y facturación en dírhams reúne en un solo proveedor las tres condiciones exigidas en la afiliación.

Comparativa: PayPal, tarjeta internacional y CMI para un comprador marroquí

Desplace la tabla

CriterioPayPal / tarjeta internacionalIntegración CMI
Tarjetas bancarias marroquíes aceptadasParcial — depende de la activación internacionalSí — todas las tarjetas de los bancos miembros
Divisa de la transacciónEUR, USD u otra — conversión necesariaDírham marroquí (MAD), sin conversión
Gastos de cambio para el compradorVariable según el banco y la tarjetaNinguno
3D SecureVariable según la redActivado por defecto en todas las transacciones
Expediente de alta del comercioEn línea, sin condición de sede en MarruecosA través de un adquirente autorizado en Marruecos — cuenta bancaria marroquí obligatoria
Liquidación al comercioPlazo variable, en divisa extranjeraEn dírhams marroquíes, según el contrato de adquirencia
Requisitos de alojamientoNinguno específicoHTTPS obligatorio, callback HTTPS accesible públicamente
Compatibilidad fiscal marroquíPosible IVA extranjeroTransacción en MAD, facturas en MAD, IVA marroquí aplicable

Resolución de problemas: errores frecuentes en la integración de CMI

Cinco problemas se repiten sistemáticamente en la puesta en producción de una integración de CMI. Estos son, con su mensaje o síntoma exacto y su solución.

Error 1 — Callback no recibido / pedido bloqueado en «en espera».
Síntoma: la página de pago de CMI se muestra, el comprador valida su pago, pero el pedido permanece en espera del lado del comercio. Causa: la URL de callback no es accesible desde los servidores de CMI — cortafuegos, regla iptables que bloquea las conexiones entrantes en el puerto 443, o alojamiento detrás de una red privada. Solución: comprobar que el puerto 443 está abierto en entrada y que la URL de callback responde a un curl desde una IP externa.

Error 2 — «Firma incorrecta» o «Invalid hash».
Síntoma: la página de CMI devuelve un error de firma. Causa: la clave compartida (store key) introducida en el formulario de integración no coincide con la configurada en el área de comercio, o los parámetros están codificados de forma distinta (codificación URL, mayúsculas y minúsculas de los campos). Solución: volver a verificar la clave en el área de comercio y asegurarse de que el orden de los campos en la cadena a firmar corresponde exactamente a la documentación de CMI.

Error 3 — Certificado SSL rechazado en la afiliación.
Síntoma: el expediente de afiliación se devuelve con la mención «sitio no seguro» o «certificado inválido». Causa: certificado autofirmado, cadena de autoridad incompleta, o dominio servido parcialmente en HTTP. Solución: probar con SSL Labs antes de presentarlo y asegurarse de que todas las páginas (incluida la de callback) responden en HTTPS con un certificado firmado por una autoridad reconocida.

Error 4 — La redirección 3D Secure falla o entra en bucle.
Síntoma: el comprador es redirigido a la página de su banco, pero el retorno al sitio del comercio termina en un error 404 o una página en blanco. Causa: la URL de retorno (okUrl / failUrl) apunta a una ruta inexistente tras el despliegue, o el servidor bloquea las redirecciones POST. Solución: verificar las URL de retorno en la configuración de CMI y asegurarse de que están activas en el alojamiento de producción.

Error 5 — Importe duplicado en el extracto del comercio.
Síntoma: un mismo pedido aparece dos veces en el extracto de CMI. Causa: el callback se ha invocado dos veces (timeout del lado del servidor → reintento de CMI) y la lógica de la aplicación no tiene idempotencia sobre la referencia del pedido. Solución: comprobar la referencia del pedido (oid) al recibir el callback y validar el pedido solo si no está ya marcado como pagado.

Para ir más lejos: conformidad e infraestructura para su actividad en Marruecos

La integración de CMI es solo uno de los aspectos de la conformidad de un sitio de e-commerce marroquí. El IVA marroquí (20 % sobre los servicios digitales) se aplica desde el momento en que el prestador está domiciliado en Marruecos y el servicio se presta a un cliente marroquí — un punto desarrollado en el artículo IVA marroquí y alojamiento web. Los datos personales recogidos durante el proceso de pago están sujetos a la ley 09-08 y a las recomendaciones de la CNDP, en particular si se alojan fuera de Marruecos — véase Conformidad con la CNDP y alojamiento fuera de Marruecos.

Para las agencias que registran nombres de dominio .ma para sus clientes, la acreditación ANRT del registrador es una condición previa: un dominio .ma registrado a través de un registrador no acreditado no es válido. El artículo Megalogi, registrador acreditado ANRT detalla este punto.

El conjunto de estas exigencias — CMI, IVA, CNDP, ANRT — forman el marco reglamentario de un proyecto de e-commerce marroquí. Gestionarlas con un solo proveedor de alojamiento que factura en dírhams, incluye el SSL y está él mismo arraigado en el tejido legal marroquí simplifica la gestión del proyecto tanto para la agencia como para su cliente.

SSL incluido, HTTPS activado, facturación en dírhams

Un alojamiento web con certificado SSL incluido, HTTPS activado desde el primer día y facturación en dírhams — los tres requisitos previos de CMI reunidos en un solo plan. Su sitio de e-commerce queda listo para la afiliación como comercio sin configuración adicional.