Cómo recoger los OTP bahameños +1 242 con llamadas REST y webhooks

¿Qué peticiones necesita una integración de la API OTP de Bahamas?

Una integración de la API OTP de Bahamas es una cadena corta de llamadas contra https://otproute.com/api/v1, autorizada por una clave Bearer con prefijo or_live_ que generas en la consola de desarrollador. El id de país de Bahamas es bs; los ids de servicio como whatsapp o telegram salen del catálogo.

1. Carga el catálogo con GET /api/v1/services y GET /api/v1/countries, y luego guarda los ids en la configuración en lugar de comparar por nombres visibles.
2. Antes de cada pedido, solicita GET /api/v1/prices?country=bs&service=<id>. La respuesta trae el precio actual e indica si hay una ruta abierta en este momento, ya que la disponibilidad cambia durante el día.
3. Crea la activación con POST /api/v1/activations y el cuerpo {"service": "<id>", "country": "bs"}. Recibes un id de activación y un número +1 242.
4. Introduce ese número en el paso de registro o inicio de sesión del producto bajo prueba.
5. Espera el código por webhook, o sondea GET /api/v1/activations/{id}. Abandona una ejecución limpiamente con POST /api/v1/activations/{id}/cancel.

Una cuenta puede tener hasta 10 claves y enviar 300 solicitudes por minuto, así que staging, CI y el portátil de un compañero pueden tener cada uno una clave distinta que revocas por separado. Los parámetros y respuestas de esta API de verificación por SMS están en la documentación de la API.

¿Cómo verifico los webhooks firmados para códigos +1 242?

El sondeo basta para una comprobación manual; cuando varias suites se ejecutan a la vez, la entrega por push es más ordenada. Registra hasta 5 endpoints en la consola de desarrollador y suscríbete a activation.sms_received, activation.expired y activation.cancelled.

Cada entrega lleva X-OTPRoute-Signature: t=<unix>,v1=<hex>. Reconstruye la cadena firmada como <t>.<raw body>, calcula HMAC-SHA256 sobre ella con el secreto del endpoint y compara el resultado con v1 usando una función de tiempo constante. Trabaja con los bytes exactamente como llegaron; volver a serializar el JSON analizado altera los espacios en blanco y los resúmenes ya no coincidirán. Rechaza cualquier marca de tiempo con más de unos pocos minutos de antigüedad para que una petición capturada no pueda repetirse.

Usa el id de activación como clave de tu manejador y hazlo idempotente, porque una entrega reintentada nunca debe marcar una prueba como superada dos veces. El artículo sobre cómo proteger los webhooks de OTP con HMAC cubre el desfase de reloj y la rotación de secretos.

¿Qué servicios de Bahamas hay en la ruta y puede el personal pedir a mano?

La ruta de Bahamas lista actualmente más de 900 servicios. Entre las opciones populares están WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Uber, Airbnb y Signal. Trata esa lista como una instantánea; lo que cuenta es la respuesta de la API en el momento del pedido.

Los compañeros que nunca tocan una clave obtienen el mismo resultado en el navegador. Inicia sesión, abre OTP Gateway, selecciona Bahamas y el servicio, lee el precio mostrado y haz el pedido. El número de verificación de Bahamas aparece con una cuenta atrás, y el código se muestra en esa misma pantalla cuando llega.

¿Qué ocurre dentro de la ventana de 20 minutos y qué pasa si no llega nada?

Cada activación permanece abierta 20 minutos. Si en ese tiempo llega un SMS, pagas el precio indicado; si la ventana se cierra vacía, o cancelas antes, el importe completo vuelve a tu monedero automáticamente.

Cuando un código bahameño no aparece:

• Deja correr la ventana antes de dar la prueba por fallida; algunos emisores ponen sus mensajes en cola.
• Reintenta más tarde o por otra ruta de servicio, porque el inventario y el comportamiento de los emisores cambian a lo largo del día.
• Comprueba que el servicio acepta números virtuales. Algunos los rechazan, y precisamente por eso existe el reembolso.
• Evita volver a pedir en un bucle rápido. Espera entre intentos para que una prueba inestable no consuma tu presupuesto de peticiones.

Más patrones de resolución de problemas están reunidos en reducir las entregas de OTP fallidas.

¿Cómo debe almacenarse y normalizarse un número +1 242?

Bahamas forma parte del Plan de Numeración de América del Norte, por lo que sus números comparten el código de país 1 con Estados Unidos y Canadá. Un número completo es el 1, el código de área 242 y un número de abonado de siete dígitos; en E.164 queda +1242 seguido de siete dígitos, once dígitos en total. Los residentes suelen citar solo los siete dígitos locales, mientras que quienes llaman desde otras zonas del plan marcan un 1 antes del 242.

De ahí se derivan dos consecuencias para tu código. Un validador que deduce el país solo a partir de +1 etiquetará a los usuarios bahameños como estadounidenses, así que inspecciona el código de área o apóyate en una biblioteca de numeración que conozca los territorios del plan norteamericano. Y guarda cada número en E.164, aplicando el formato solo para mostrarlo, para que las búsquedas y la deduplicación sean coherentes. Los textos de verificación en líneas bahameñas suelen llegar en inglés, el idioma oficial, lo que centra las comprobaciones de localización en el formato de los números y las etiquetas de país más que en textos traducidos.

¿Por qué los equipos de producto prueban los registros con Bahamas?

El turismo, la hostelería y los servicios financieros sostienen buena parte de la economía bahameña, así que las plataformas de reservas, las apps de transporte y reparto, los productos de pago y los bancos con clientes en el Caribe necesitan una vía funcional para usuarios +1 242. Un número +1 242 para pruebas permite a un ingeniero de QA confirmar que un formulario acepta el número, que el selector de país muestra Bahamas en lugar de absorberlo en EE. UU., y que el texto del consentimiento para SMS se muestra correctamente. Un buen enrutamiento de OTP también implica elegir el país adecuado en cada caso de prueba en lugar de usar por defecto un número del continente. La guía de pruebas de QA muestra cómo integrarlo en suites automatizadas. Mantén todas las comprobaciones en cuentas que pertenezcan a tu organización y respeta las condiciones de cada servicio; la Política de uso aceptable de OTP Route se aplica a todos los pedidos.

¿Es posible un número bahameño de larga duración y cómo se factura el uso?

No hay un número de larga duración de autoservicio para Bahamas. Los números dedicados son un producto de EE. UU. y Canadá desde $1.95/mes, con SMS entrantes y salientes, llamadas desde el navegador y reenvío por webhook. Si tu equipo necesita una línea bahameña continua, escribe a [email protected]; que sea posible depende de la normativa local y no puede prometerse.

El uso sale de un único monedero prepago en USD, sin cuota mensual y sin plan que elegir. Recarga con tarjeta o con USDT/USDC, y llega a tu bandeja de entrada una factura en PDF por cada recarga. Para trabajo de integración, pide que se cambie una cuenta de desarrollo a sandbox: devuelve números y códigos simulados, así que todo el flujo puede ejercitarse sin gastar fondos del monedero. La página de precios muestra cómo aparecen los cargos.

Preguntas frecuentes

¿Puedo probar el flujo de registro de Bahamas de mi app sin una SIM local?

Sí. Pide un número +1 242 en OTP Gateway para el servicio que estás probando, introdúcelo en tu flujo y lee el código en el panel o por webhook. Pagas desde $0.20 por código, y solo cuando llega el SMS.

¿Cuál es el id de país de Bahamas en la API?

Es bs. Pásalo a GET /api/v1/prices y en el cuerpo de POST /api/v1/activations.

¿Mi biblioteca telefónica tratará +1 242 como un número de EE. UU.?

Solo si deduce el país únicamente a partir del código de país. Comprueba el código de área, o usa una biblioteca que incluya datos de los territorios del plan norteamericano, para que los números bahameños se etiqueten correctamente.

¿Me cobran si el código nunca llega?

No. Cuando no llega nada en 20 minutos, o cancelas, el importe completo vuelve a tu monedero automáticamente.

¿Puedo conservar un número de verificación de Bahamas para inicios de sesión futuros?

No como producto de autoservicio. Los números dedicados de larga duración existen solo en Estados Unidos y Canadá; para una línea bahameña, escribe a [email protected] y el equipo te dirá qué permite la normativa local.

¿Cuántas peticiones puede enviar una suite de pruebas?

Hasta 300 solicitudes por minuto por cuenta, repartidas entre hasta 10 claves de API. Sondear cada pocos segundos, o pasar a webhooks, te mantiene cómodamente dentro de ese límite.

¿Puedo recargar el monedero con stablecoins?

Sí. El monedero acepta tarjetas y USDT/USDC, y cada recarga llega con una factura en PDF por correo.

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.