Revende números virtuales privados con la API de SMS Activate App: compra en tu cuenta a nuestro precio, suma tu margen y atiende a clientes con tu bot o web.
Esta guía es para ti si quieres ofrecer números virtuales privados a tus propios clientes con un servicio de marca blanca, un bot de Telegram o una web pequeña. Explica cómo funciona el montaje, cómo poner precio a cada número, qué llamadas a la API necesitas, cómo funciona la facturación y dónde termina nuestra responsabilidad.
Cómo funciona la reventa
Tienes una cuenta en SMS Activate App y una clave de API. Compras los números en esa cuenta a través de la API. Después, tu bot o tu web muestra a cada cliente su número y los códigos de verificación por SMS que llegan a él.
Cada número es un número móvil o local real del rango de un operador, según el país. Tu cuenta lo conserva durante un plazo de 28 días. Recibe SMS y llamadas.
Tus clientes son tuyos. Tú cobras sus pagos, respondes a sus preguntas y fijas tus propias condiciones. No necesitan una cuenta con nosotros. Tienes más información sobre este modelo en la página de revendedores.
Fija tu precio y tu margen
Nuestro precio se fija por número y por país. Lo lees en directo desde la API:
- GET /v1/public/countries devuelve los campos minPriceCents, maxPriceCents y availableNumbers de cada país.
- GET /v1/public/numbers/search?country=US&limit=20 devuelve los números a la venta en ese momento. El campo priceCents de cada uno es tu precio.
Todos los importes de la API van en céntimos de dólar estadounidense (USD), como números enteros.
Tu precio es nuestro precio por ese número más tu margen. Si un número te cuesta C y lo vendes a P, tu margen es P menos C. Tu porcentaje de margen es (P menos C) dividido entre P. El recargo es otra cifra: (P menos C) dividido entre C. El recargo siempre es la mayor de las dos, así que decide a cuál te refieres antes de fijar un objetivo.
Recalcula a partir del precio en directo en cada venta. No trabajes con una lista fija, porque los precios pueden cambiar según el país. No hay descuento para revendedores ni tramos por volumen: compras al precio normal, el mismo que aparece en precios.
Incluye también estos costes en tu presupuesto:
- Compras definitivas. Un número es definitivo y no se reembolsa una vez emitido, aunque una plataforma lo rechace.
- Decisiones de la plataforma. Es la plataforma, no nosotros, quien decide si acepta un número. Deja que tus clientes comprueben primero que un número funciona con su servicio, o incluye ese riesgo en tu precio.
- Renovación automática. Un número se renueva y se cobra cada 28 días, salvo que desactives la renovación automática.
- Comisiones de pago. Tu propio procesador de pagos te cobra por cada pago de un cliente.
- Tiempo de soporte. Tus clientes te harán preguntas, y responderlas te lleva tiempo.
El flujo de la API, paso a paso
La URL base es https://api.sms-activate.app/v1/public. Todas las llamadas, el catálogo incluido, necesitan tu clave en la cabecera Authorization: Bearer vpn_xxx.
- Consulta los países. Llama a GET /countries para ver qué países tienen números y su rango de precios.
- Busca números. Llama a GET /numbers/search?country=US&limit=20 para ver los números disponibles en un país, cada uno con tu precio en priceCents.
- Compra un número. Llama a POST /numbers con un cuerpo JSON {"phone": "+15551234567", "country": "US"} y una cabecera Idempotency-Key con un UUID. Si en un reintento envías la misma clave, no se te cobra dos veces. Una compra correcta devuelve 201 con el número, chargedCents y balanceAfterCents. Hay dos campos opcionales: autoRenew (por defecto true) y note. Usa note para guardar la referencia de tu cliente.
- Lee los códigos. Llama a GET /numbers/{id}/sms para un número, o a GET /sms para todos tus números. Ambas llamadas usan paginación por cursor. Para que los códigos te lleguen solos, llama a PATCH /numbers/{id} con {"forwardWebhookUrl": "https://your-app.example.com/sms"}: a partir de ahí, cada SMS y cada llamada a ese número se envían a tu servidor, firmados con HMAC-SHA256. Asigna cada código al cliente correcto antes de mostrarlo.
- Gestiona el plazo. Si un cliente no renueva, llama a PATCH /numbers/{id} con {"autoRenew": false}. Para liberar un número que ya no necesitas, llama a DELETE /numbers/{id}.
Otras dos llamadas te ayudan con la contabilidad. GET /balance devuelve tu saldo en céntimos. GET /v1/me/transactions muestra tu extracto.
Los errores tienen siempre la misma forma: {"error": "<code>", "message": "...", "reqId": "..."}. Decide qué hacer según el código de error, no según el estado HTTP. Algunas negativas, como insufficientbalance, nonumbers y priceexceeded, son respuestas. Muéstraselas a tu cliente en lugar de reintentar a ciegas. Ante ratelimited, espera el tiempo que indique la cabecera Retry-After.
La especificación completa está en el archivo OpenAPI, y la documentación de la API explica cada llamada.
Facturación: tu saldo con nosotros
Tus compras se pagan con el saldo de tu cuenta. En la web recargas en cripto (USDT). El bot de Telegram también acepta tarjeta bancaria en rublos y Telegram Stars. Cuando vinculas tu cuenta, ambos usan un único saldo.
Ten saldo suficiente antes de tus horas de más actividad. Una compra con saldo insuficiente se rechaza con insufficient_balance, y tu cliente espera mientras recargas.
Las retiradas se pagan solo en USDT (TRON, BSC o TON). Las haces tú mismo en tu cuenta del sitio o en el bot de Telegram: hasta 100 $ al día se pagan automáticamente en pocos minutos, y un importe mayor lo paga soporte a mano si lo pides. El dinero pagado con tarjeta, recibido como bono o como transferencia se puede retirar 180 días después de abonarse; las recargas en cripto, al momento. El mínimo es de 10 $. La comisión es del 10 % del importe, con un mínimo de 5 USDT, y se descuenta del importe.
Tus propias compras y el programa de afiliados
Las compras en tu propia cuenta, o en cualquier cuenta que controles, nunca generan comisión de afiliado.
Algunos clientes preferirán tener su propia cuenta. Envíales tu enlace de afiliado. Así ganas del 10 al 30 % de nuestro margen (no del precio) en sus compras y renovaciones mientras exista su cuenta; la parte sube con cuántas de las personas que trajiste han comprado, del 10 % por los primeros 3 compradores al 30 % a partir del comprador 3001. Cada comisión se abona en tu saldo 30 días después de la compra. Tienes los detalles en las páginas del programa de afiliados y de revendedores.
Soporte
Tus clientes te contactan a ti. Tú nos contactas a nosotros. Una persona responde por correo en support@sms-activate.app o en Telegram en t.me/BestVoipTelegram, normalmente en menos de 24 horas.
No prometas a tus clientes más de lo que nosotros te prometemos a ti. No prometemos que llegue cada código ni que una plataforma acepte un número. La mayoría de los códigos llegan pocos minutos después de que la plataforma los envíe. Pide a tus clientes que prueben un número con su servicio antes de depender de él.
Vídeos útiles
Vídeos de terceros sobre precios, bots de Telegram y diseño de API. Enseñan técnicas generales y no tratan sobre nuestro servicio.
- Markup vs Margin, they are not the same thing! (Brad Flynn): la diferencia entre recargo y margen, con ejemplos numéricos.
- The 6 Components of a SaaS Pricing Model (Willingness to Pay): la métrica, el periodo, los descuentos y el punto de precio de un modelo de precios.
- Aiogram Basics: Build Your First Telegram Bot with Python (Almaz | Coding): los conceptos de los bots de Telegram y un primer bot funcional en Python.
- Build a Python Telegram Bot that Accepts Stars Payment (2025) (Nikandr Surkov): cobrar en Telegram Stars dentro de un bot en Python.
- What is API Idempotency and Why Is It Important? (Be A Better Dev): por qué una compra reintentada no debe cobrarse dos veces y cómo lo evita una clave de idempotencia.
- Polling vs Webhooks | System Design Tradeoffs (SoftwareDude): cuándo pedir datos nuevos cada cierto tiempo y cuándo hacer que te los envíen.
Empieza
- Crea una cuenta gratuita en la página de registro.
- Crea una clave de API en el panel de tu cuenta, en la pestaña de claves de API.
- Lee la documentación de la API y el archivo OpenAPI.
- Consulta los precios en directo en precios.
- Compra un número y prueba tu flujo completo antes de abrir las ventas.