Lista de control previa para recibir códigos de verificación +375 de Bielorrusia

¿Qué debe estar preparado antes de pedir un número +375?

Antes de usar un número +375 para pruebas, marca estos puntos:

• Una cuenta y un monedero con fondos. Crea una en la página de registro con un correo y un código de 6 dígitos, o con el inicio de sesión de Google, y luego añade un pequeño saldo. Activa la autenticación de dos factores TOTP en la cuenta que guarda las claves de API.
• Una clave Bearer con el prefijo or_live_, creada en la consola de desarrolladores. Da claves separadas a CI y al desarrollo local; una cuenta puede tener hasta 10.
• Los dos ids que vas a enviar. Bielorrusia es by en la API, y el id del servicio es el valor api_service que devuelve GET /api/v1/services.
• Un endpoint receptor si piensas usar webhooks, con su secreto de firma guardado fuera del repositorio.
• Una cuenta de prueba en tu propio producto a la que se le permita cambiar o añadir un número de teléfono.
• Una librería de teléfonos configurada para la región BY, de modo que el número que pegues en tu formulario de registro se analice como lo escribiría un usuario bielorruso real.

¿Cómo se escriben los números bielorrusos y cómo debe guardarlos tu app?

Bielorrusia usa el código de país +375 seguido de un número nacional de nueve dígitos. Las líneas móviles empiezan con códigos de operador como 25, 29, 33 o 44, de modo que un valor almacenado se ve así: +37529XXXXXXX.

Lo difícil es la costumbre nacional. Dentro del país, la gente suele escribir un móvil con un 80 inicial, como en 8 029 XXX-XX-XX, que proviene del prefijo de marcación de larga distancia. Ese 80 debe eliminarse antes de añadir el código de país; un formulario que lo conserva produce una cadena E.164 no válida que algunos servicios de verificación rechazan en silencio. Buenas pruebas de normalización para un número de verificación de Bielorrusia:

• aceptar +375 29 ..., 375 29 ... y 8 029 ... y guardar los tres de forma idéntica;
• mostrar el número con una agrupación cómoda para el usuario local, pero enviar solo E.164 a tu capa de SMS o de verificación;
• rechazar un número que todavía tenga 80 después del 375.

El bielorruso y el ruso son ambos idiomas oficiales, y el ruso es el que más se usa en el día a día. Muchos servicios envían el texto del código en ruso o en inglés según la configuración regional de la cuenta, así que comprueba que tu app muestra bien el cirílico en cualquier pantalla que reproduzca el mensaje.

¿Para qué servicios puede recibir códigos un número de verificación de Bielorrusia?

El enrutamiento OTP de Bielorrusia en OTP Route cubre actualmente más de 1,400 servicios bajo el id by. Entre las rutas populares de la instantánea actual están Telegram, Viber, WhatsApp, Signal, Google (Gmail y YouTube), Instagram, TikTok, Microsoft y Outlook, LinkedIn, Discord, Amazon y AliExpress.

La disponibilidad de cada ruta cambia durante el día, así que toma una lista como esta como punto de partida, no como una promesa. Antes de una ejecución, consulta GET /api/v1/prices?country=by&service=<id> para conocer el precio actual y si la ruta puede aceptar un pedido ahora mismo. Consulta el enrutamiento de OTP por país cuando elijas entre países.

Paso a paso: el flujo de la API OTP de Bielorrusia desde un script de pruebas

Cada solicitud va a https://otproute.com/api/v1 con tu clave Bearer. La API de verificación por SMS es lo bastante pequeña como para envolverla en un único helper:

1. Llama a GET /api/v1/balance y detén el trabajo pronto si el monedero es insuficiente para la suite.
2. Llama a GET /api/v1/prices?country=by&service=telegram (cambia el id por el de tu servicio) y registra el precio que vas a pagar.
3. Crea el pedido con POST /api/v1/activations y un cuerpo como {"service": "telegram", "country": "by"}. Guarda el id de activación y el número +375 de la respuesta.
4. Envía ese número al paso de teléfono de tu propia app y dispara el código.
5. Recoge el código de un evento activation.sms_received, o consulta GET /api/v1/activations/{id}. El límite es de 300 solicitudes por minuto.
6. Si la prueba se aborta, llama a POST /api/v1/activations/{id}/cancel para que la retención vuelva al monedero de inmediato.

Para los webhooks, lee la cabecera X-OTPRoute-Signature (t=<unix>,v1=<hex>), calcula HMAC-SHA256 de <t>.<raw body> con el secreto del endpoint, compara en tiempo constante y descarta las entregas con marcas de tiempo antiguas. Usa el id de activación como clave en tu manejador para que una entrega repetida sea inofensiva. La documentación de la API y la guía para proteger los webhooks de OTP con HMAC cubren los detalles.

Paso a paso: la misma tarea desde el panel

El personal de soporte que necesita un código de vez en cuando puede prescindir de la API:

1. Abre el OTP Gateway en el panel y elige Bielorrusia.
2. Selecciona el servicio; el precio de esa ruta se muestra antes de confirmar.
3. Copia el número +375 e introdúcelo en la app que estás probando.
4. Observa la tarjeta del pedido. El código aparece ahí en cuanto llega.

Si no llega nada en 20 minutos, el pedido se cierra y se te reembolsa el importe completo. Solo pagas cuando se entrega un código.

Solución de problemas: el código +375 no llegó

Causas habituales y el siguiente paso para cada una:

• El servicio rechazó el número. Algunas plataformas rechazan los números virtuales. La regla de reembolso existe precisamente para este caso; prueba otra ruta de servicio u otro país si la prueba lo permite.
• El número se introdujo en formato nacional. Vuelve a comprobar que tu formulario envió +375 más nueve dígitos, sin el 80.
• La ruta está ocupada. Deja que la ventana siga su curso en lugar de cancelar al cabo de un minuto, y vuelve a intentarlo más tarde.
• Tu script repite pedidos en un bucle cerrado. Añade un retroceso entre intentos; los pedidos repetidos y rápidos en un mismo servicio rara vez ayudan y pueden parecer abuso a la plataforma de destino.

Otros patrones de fallo en pedidos +375 se tratan en reducir las entregas fallidas de OTP.

¿Existe una línea bielorrusa de largo plazo y cómo funciona la facturación?

No. OTP Route no tiene un número de largo plazo de autoservicio para Bielorrusia. Si tu equipo necesita uno para un caso de operaciones o soporte, escribe a [email protected] y descríbelo; que se pueda ofrecer algo depende de la normativa local y no se promete nada. Los Números Virtuales Dedicados son un producto de EE. UU. y Canadá, desde $1.95/month, con SMS entrantes, SMS salientes y llamadas desde el navegador.

Los pedidos de Bielorrusia salen del mismo monedero prepago en USD que cualquier otra ruta, sin cargos mensuales y sin nivel que elegir. Recárgalo con tarjeta o con las stablecoins USDT/USDC; una factura en PDF de cada recarga llega a tu bandeja de entrada. Los desarrolladores pueden pedir una cuenta sandbox que devuelve números y códigos simulados, que es la forma más barata de comprobar una integración antes de hacer pedidos reales. Usa cada número solo para tu propio producto o tus propias cuentas legítimas, respeta los términos de cada servicio y ten en cuenta que se aplica la Política de Uso Aceptable de OTP Route. Las cifras actuales están en precios.

Preguntas frecuentes

¿Puedo probar el registro de mi app en Bielorrusia sin una SIM local?

Sí. Pide un número +375 para tu servicio en el OTP Gateway, envíalo en tu formulario de registro y lee el código en el panel o por la API.

¿Cuál es el id de país de Bielorrusia en la API de OTP Route?

Es by. Úsalo en GET /api/v1/prices y en el cuerpo de POST /api/v1/activations.

¿Debo guardar los números bielorrusos con el prefijo 80?

No. Guárdalos en E.164 como +375 seguido de nueve dígitos y elimina el 80 nacional; de lo contrario, muchos servicios tratarán el número como no válido.

¿Qué pasa con mi dinero si el número +375 nunca recibe un código?

Cuando la ventana de 20 minutos termina sin ningún SMS, o cancelas, el cargo completo vuelve a tu monedero automáticamente.

¿En qué idioma llegará el SMS de verificación?

Lo decide el servicio emisor. Para los números bielorrusos suele ser ruso o inglés, según el idioma de la cuenta o del dispositivo.

¿Puedo conservar un número +375 para futuros inicios de sesión?

No en autoservicio. Los Números Dedicados de largo plazo existen solo para EE. UU. y Canadá; para Bielorrusia puedes escribir a [email protected] para consultarlo, sin ninguna promesa de disponibilidad.

¿Hay forma de probar la integración sin gastar fondos del monedero?

Sí. Bajo petición, una cuenta de desarrollo puede pasarse a sandbox, que devuelve números y códigos simulados para pruebas de principio a fin.

Los nombres de los servicios son marcas registradas de sus respectivos propietarios. OTP Route no está afiliado a ellos. Usa los números de forma lícita y respeta las condiciones de cada servicio y nuestra Política de Uso Aceptable.