Separe catálogo público de recepción privada
Los datos públicos describen servicio, país, precio y duración. No contienen número de teléfono asignado ni código. Las activaciones pertenecen a una cuenta y orden con seguimiento privado separado.
El directorio de servicios y países es independiente de las ofertas comerciales. El contrato de integración requiere un catálogo API con precios y disponibilidad autorizados para pedidos.
Catálogo y pedidos
El contrato existente especifica GET /catalog/products y GET /catalog/products/:slug. El backend suministra precio, duración y disponibilidad explícita; la falta de stock permanece desconocida.
Los pedidos envían un identificador de producto con una clave de idempotencia. El servidor verifica precio y stock antes de la reserva o asignación. Leer una página no activa acciones sensibles.
Estados de recepción
El módulo distingue asignando, esperando, recibido, completado, cancelado, expirado y fallido. La asignación puede estar pendiente sin un número; la espera real y la recepción requieren el número y la expiración del backend.
Cada mensaje tiene identificador estable, marca temporal y texto. El backend puede extraer un código; la interfaz no debe adivinar un OTP. El directorio público no contiene número asignado ni código privado.
Acciones y actualizaciones autorizadas
GET /activations y GET /activations/:id son lecturas privadas. POST /activations/:id/actions envía cancelar, finalizar o reenviar con una clave de idempotencia. El backend anuncia y vuelve a verificar acciones permitidas.
Las lecturas privadas usan la sesión, idioma de interfaz y caché adecuada. Los intervalos de seguimiento siguen el contrato; la expiración del servidor y estado tienen prioridad sobre un temporizador del navegador.
Pago, asignación y secretos del proveedor
La factura fija el activo, la red, la cantidad, la dirección y la expiración. La confirmación del pago y la asignación del número son eventos separados. El backend maneja fallos e intentos sin asignación doble.
Las claves del proveedor y secretos de pago permanecen en el servidor. La API autoriza cada lectura de cuenta, define la retención de mensajes y mantiene privados los identificadores internos del proveedor. Esta página documenta el contrato de integración y no anuncia una API pública operativa.
Referencia del endpoint del contrato
| Método | Endpoint | Rol |
|---|---|---|
GET | /catalog/products | Catálogo público |
GET | /activations | Activaciones de cuenta |
GET | /activations/:id | Seguimiento privado de recepción |
POST | /activations/:id/actions | Acción autorizada |
Estas son las rutas de contrato frontend existentes, no puntos finales de producción publicados. Queda por conectar proveedor, autenticación e integración de pago.