Integrar Airtel Money y Moov Money en un sitio web en Gabón

Por Gabon Connect

Integrar Airtel Money y Moov Money en un sitio web consiste en conectar su servidor con las plataformas de pago de los dos operadores, para que el cliente pague desde su teléfono sin tarjeta bancaria. El cliente recibe una solicitud en el móvil, la confirma con su código secreto y su sitio recibe la confirmación. Esta guía explica qué hay que prever, por orden.

Por qué Mobile Money y no la tarjeta bancaria

En Gabón, gran parte de sus clientes paga con el teléfono y no tiene una tarjeta bancaria que pueda usar en internet. Un sitio que solo acepta tarjeta pierde a esos clientes justo en el momento en que quieren pagar. Ofrecer Airtel Money y Moov Money es aceptar el medio de pago que ya llevan en el bolsillo.

Las dos redes conviven: un cliente de Moov no paga con Airtel Money, y al revés. Un flujo de pago serio ofrece las dos y deja que el cliente elija su operador antes de introducir su número.

Acceder a las API de los operadores

Airtel publica su documentación técnica en su portal para desarrolladores, developers.airtel.africa. Gabón figura en la lista de países, y al elegir Gabón el portal remite a developers.airtel.ga, que pide crear una cuenta antes de consultar la documentación. La sección de cobros se llama «Collection» y el pago que se lanza en el teléfono del cliente se llama «USSD push».

Para Moov Money en Gabón no encontramos documentación pública de la API para comercios en la fecha de actualización de esta guía. El acceso se negocia con Moov Africa Gabon, que abre la cuenta de comercio y entrega los datos técnicos.

Segunda vía: pasar por un agregador de pagos local, que ya ha firmado con los dos operadores y ofrece una sola interfaz para ambos. Gana en plazo y en sencillez, paga una comisión al intermediario y depende de su disponibilidad. La elección correcta depende de su volumen y del tiempo que pueda dedicar a los trámites.

  • Una cuenta de comercio abierta a nombre de la sociedad, con su documentación (RCCM, NIF).
  • Credenciales de prueba y, tras la validación, credenciales de producción.
  • Una dirección de retorno (callback) de su servidor, declarada ante el operador o el agregador.

El flujo de pago, paso a paso

Este es el flujo que ponemos en marcha, tal como funciona en las plataformas que operamos para nuestros clientes, entre ellas el cobro de suscripciones descrito en nuestros proyectos.

  1. El servidor crea la factura y calcula el importe. El navegador nunca fija el precio: un importe enviado por el cliente puede manipularse.
  2. El cliente elige Airtel Money o Moov Money e introduce su número.
  3. El servidor envía la solicitud de pago al operador, que la muestra en el teléfono del cliente.
  4. El cliente confirma con su código secreto en su teléfono. Su sitio nunca tiene acceso a ese código.
  5. El operador notifica el resultado a su servidor. El servidor comprueba la notificación y marca la factura como pagada.
  6. El cliente ve la confirmación en pantalla y recibe su recibo.

Entre el paso 3 y el paso 5 pasa el tiempo que tarda el cliente en confirmar. La página debe esperar sin bloquearse: un mensaje claro («Confirme el pago en su teléfono») y una comprobación periódica del estado de la factura.

Los puntos de seguridad que no se pueden descuidar

  • El importe se calcula en el servidor, nunca se lee del formulario.
  • La notificación del operador se comprueba antes de darla por buena: firma, origen, importe y referencia comparados con la factura.
  • Una misma notificación recibida dos veces solo abona una vez. Los operadores pueden reenviar un mensaje.
  • Las claves de acceso se guardan en el servidor, fuera del código publicado y fuera del navegador.
  • Cada intento queda registrado: quién, cuánto, qué operador, qué resultado. Ese registro resuelve los litigios.

En nuestros proyectos, este módulo está cubierto por pruebas automatizadas: un pago aceptado, un pago rechazado, una notificación duplicada, una notificación falsificada. Es la parte del sitio donde un error cuesta dinero, y merece probarse en cada actualización.

Cuando la solicitud no prospera

Una solicitud de pago puede fallar por motivos corrientes: saldo insuficiente, teléfono apagado, red débil, un cliente que no confirma a tiempo. El sitio debe decirlo con claridad y proponer reintentar, sin crear una segunda factura.

También añadimos un enlace de pago de respaldo, que se envía al cliente cuando la solicitud directa no prospera. Puede pagar más tarde, desde otro teléfono, sin repetir todo el flujo.

Conciliación y contabilidad

Un cobro solo termina cuando aparece en el lugar correcto de sus cuentas. Cada pago lleva una referencia que une la factura, la transacción del operador y el recibo. La conciliación automática compara lo que su sitio registró con lo que el operador ha abonado realmente, y señala las diferencias.

Un marketplace necesita ir más lejos: retener los fondos hasta la entrega y luego repartirlos entre vendedor y repartidor. Lo construimos para uno de nuestros clientes, con recibos en PDF e historial de pagos.

Dónde colocar el pago: sitio, aplicación o enlace

La misma conexión con los operadores puede servir a varios puntos de venta. El servidor es el mismo, solo cambian las pantallas.

  • En un sitio web: un botón de pago al hacer el pedido o en la factura, sin registro obligatorio si su actividad lo permite.
  • En una aplicación móvil: el mismo flujo, con la ventaja de que el número del cliente suele conocerse ya.
  • Por enlace: un enlace de pago enviado por SMS, correo electrónico o WhatsApp, útil para una factura puntual o un recordatorio.

Empiece por el punto que genera más ingresos. Los demás se conectan después al mismo servidor, sin rehacer la integración.

Probar antes de abrir al público

Un pago se prueba como un circuito completo, desde el clic del cliente hasta el asiento contable. Los operadores y agregadores suelen ofrecer un entorno de pruebas, separado de producción, con sus propias credenciales.

  1. Pago aceptado: la factura pasa a «pagada» una sola vez y se envía el recibo.
  2. Pago rechazado o abandonado: la factura sigue abierta y el cliente puede reintentar.
  3. Notificación recibida dos veces: un solo abono.
  4. Notificación falsificada o importe distinto: rechazada y registrada.
  5. Servidor caído unos minutos: los pagos confirmados entretanto se recuperan bien.

Tras la apertura, vigile de cerca los primeros días: la proporción de solicitudes que prosperan, los plazos de notificación y las reclamaciones. Son ellos los que dicen si el flujo resulta claro para sus clientes.

Las comisiones por transacción

Cada pago cobrado soporta unas comisiones, fijadas por el operador o el agregador en su contrato de comercio. No forman parte de nuestro servicio y varían según el contrato, el volumen y el canal elegido.

Pida la tabla exacta antes de firmar y decida quién las asume: usted, o el cliente mediante un importe ajustado. Esa decisión se aplica en el servidor, al calcular la factura, y debe mostrarse con claridad al cliente antes de que confirme.

Plazos y presupuesto

Nuestro servicio «Pasarela de pago Mobile Money» se ofrece a partir de 551 200 FCFA sin impuestos, con un plazo indicativo de 7 a 14 días una vez obtenidos los accesos. El precio exacto depende de su sitio, del número de flujos de pago y de la conciliación que necesite.

El plazo más largo no suele ser técnico: es la apertura de la cuenta de comercio con el operador. Inicie ese trámite al principio del proyecto.

Si necesita reunir varios medios de pago en un sitio, una aplicación y un marketplace, el servicio «Sistema de pago multicanal» se ofrece a partir de 2 754 200 FCFA sin impuestos.

Preguntas frecuentes

¿Se pueden aceptar Airtel Money y Moov Money en el mismo sitio?

Sí. Son dos integraciones distintas, una por operador, o una sola si pasa por un agregador que cubre los dos. El cliente elige su operador antes de introducir su número.

¿Dónde está la documentación de la API de Airtel Money para Gabón?

En el portal para desarrolladores de Airtel Africa, developers.airtel.africa. Al elegir Gabón remite a developers.airtel.ga, que exige crear una cuenta para acceder a la documentación.

¿Existe documentación pública de la API de Moov Money Gabón?

No la encontramos en la fecha de actualización de esta guía. El acceso técnico se solicita a Moov Africa Gabon al abrir la cuenta de comercio.

¿El cliente introduce su código secreto en mi sitio?

No. Confirma el pago en su propio teléfono. Su sitio nunca ve su código secreto.

¿Qué ocurre si el cliente no confirma la solicitud?

La transacción queda pendiente y después falla. El sitio lo indica con claridad, propone reintentar y puede enviar un enlace de pago de respaldo.

¿Cuánto cuesta la integración?

Nuestra pasarela de pago Mobile Money se ofrece a partir de 551 200 FCFA sin impuestos. Las comisiones del operador o del agregador se suman y las factura cada uno de ellos.

¿Se puede probar la integración antes de abrirla a los clientes?

Sí. Los operadores y agregadores suelen ofrecer un entorno de pruebas con sus propias credenciales. Allí comprobamos pagos aceptados, rechazados, duplicados y falsificados antes de la puesta en marcha.

¿Hace falta una sociedad registrada?

Sí, para una cuenta de comercio: el operador o el agregador pide la documentación de la sociedad, entre ella el RCCM y el NIF.

El servicio relacionado

Pasarela de Pago Mobile Money (API)

Precio indicativo, plazo y detalle del servicio en su ficha.

Ver el servicio

Fuentes

  1. Portal para desarrolladores de Airtel Africa (elección del país; para Gabón se exige una cuenta)(developers.airtel.africa)
  2. Documentación de Airtel, sección Collection, USSD push(developers.airtel.africa)
  3. Nuestros proyectos: cobro de suscripciones y pagos de un marketplace con Mobile Money(gabonconnect.com)
En directo
« C'est formidable de voir comment Gabonova s'engage à accompagner ses clients dans leur projet immobilier à Libreville. La sécurité et la négociation sont des aspects si importants dans ce domaine. J'aime l'idée que rien n'est laissé au hasard, cela rassure vraiment les futurs acheteurs! »laurent.boutillier · hace 3 meses« Jolie »Visitante · hace 3 meses« Super »Visitante · hace 3 meses« Tres interesantes »Visitante · hace 3 meses« Bonne opportunité 👌🏽 »Visitante · hace 3 meses« Très belle maison »Visitante · hace 3 meses« Very helpful and great service! »Elin Nilsson · hace 3 meses« Très belle initiative !🤩 »Visitante · hace 9 meses« 👏👏👏 »jeansebastiencampos · hace 10 meses« 👏🎉 »call_me_hertaa · hace 11 meses« 📊👍👏👏 »oyoky_off · hace 11 meses« 📊👍🇬🇦 »Visitante · hace 11 meses
Logo

Empresa internacional de transformación digital e innovación tecnológica, implantada en Libreville y en Madrid.

Empresa tecnológica registrada en Gabón (Gabon Connect S.A.R.L.U., RCCM GA-LBV-01-2025-B13-00283) y en España (Gabon Connect España, NIF B88909304), editora de Gabonova y Wiigo.

Nuestras sedes

LibrevilleGabon Connect S.A.R.L.U.160, Rue Cheikh Ahmadou Bamba Mbacké, Bd Triomphal, Apdo. 5817
MadridGabon Connect España, S.L.U.Calle Eduardo Chillida 225, 28051 Madrid

© 2026 Gabon Connect. Todos los derechos reservados.