Leer las confirmaciones de mobile money en tiempo real

La necesidad

Vende en línea en un país donde se paga con mobile money. El operador confirma cada pago por SMS al número del comerciante, de inmediato. Una API, cuando existe, exige semanas de trámites, una sociedad registrada, un volumen mínimo y a menudo una parte de cada transacción.

Mientras tanto, la confirmación que necesita ya está llegando, a un teléfono, en forma de mensaje.

Cómo funciona

La SIM que recibe las confirmaciones del operador es una de las tarjetas SIM emparejadas con su pasarela. A partir de ahí:

1. El mensaje llega al teléfono y la pasarela lo registra, en su propia máquina. Un operador escribe desde un código corto o un nombre, no desde un número: añádalo a Remitentes que registrar en Ajustes > Recepción, o será rechazado como cualquier servicio desconocido. El Registro muestra su grafía exacta desde su primer mensaje.
2. Un webhook llama a su aplicación en cuanto llega el SMS: suscríbalo a message.received en la página Webhooks. La llamada va firmada con HMAC-SHA256, para que pueda probar que viene de su pasarela, y lleva los identificadores del mensaje, nunca su texto.
3. Su código lee el mensaje mediante la API de la pasarela, con una clave limitada al alcance Lectura: GET /api/v1/messages/{id} devuelve el remitente y el texto.
4. Su código comprueba el remitente, lee el importe y la referencia, y marca el pedido como pagado.

Nada se consulta en bucle y nada espera: el webhook sale cuando el SMS llega.

Lo que debe saber antes de construir sobre esto

• El formato del mensaje pertenece al operador. Puede cambiar su redacción sin avisarle, y un analizador escrito sobre la antigua deja entonces de reconocerlo. Registre lo que no haya sabido analizar, y vigile ese registro.
• Un SMS no es una prueba de pago. Dice lo que el operador envió a ese número. Para un importe que cuenta, confirme con el extracto o la API del operador antes de entregar algo irreversible.
• Reserve la SIM receptora para ese uso, en un teléfono que permanezca cargando. Una confirmación que llega con el teléfono apagado se lee al volver, no se pierde, pero se lee tarde.
• Compruebe las condiciones de su operador: lo que tiene derecho a automatizar en una cuenta de mobile money depende de su norma, no de la nuestra.

Lo que hace falta

Un teléfono emparejado, la SIM que recibe las confirmaciones, el remitente del operador registrado en Ajustes > Recepción, un webhook sobre message.received, una clave de API con alcance Lectura y un punto de entrada en su aplicación. La pasarela guarda los mensajes; la decisión de aceptar un pago sigue estando en su código.