Español
API OTP de Samoa: cómo probar registros con +685 en el Pacífico
OTP Route te permite recibir códigos de verificación de Samoa (+685): pides un número de un solo uso en el OTP Gateway y lees el SMS en el panel o lo recoges mediante la API y los webhooks, desde $0.20 por código. Tienes 20 minutos para que llegue el mensaje y, si no llega, se te reembolsa el importe completo.
Samoa de un vistazo para equipos de producto y QA
Samoa es una nación independiente del Pacífico con el samoano y el inglés como lenguas oficiales. Hay una gran comunidad samoana en Nueva Zelanda, Australia y Estados Unidos, así que las aplicaciones de remesas, mensajería y viajes suelen tener que funcionar para usuarios que se mueven entre esos países y su tierra de origen.
Hay dos particularidades que conviene conocer. Primero, Samoa (+685) es un país distinto de Samoa Americana, que forma parte del plan de numeración norteamericano con el prefijo +1 684; confundirlos en un selector de países hace que los códigos vayan al lugar equivocado. Segundo, en 2011 Samoa pasó al lado oeste de la Línea Internacional de Cambio de Fecha y mantiene una hora muy adelantada respecto a UTC, lo que la convierte en un caso útil para probar los límites de fecha en la lógica de caducidad.
Para un equipo de producto, Samoa rara vez es un mercado de lanzamiento por sí solo. Suele aparecer dentro de un despliegue por el Pacífico, como requisito de una aplicación orientada a la diáspora o porque una organización asociada en Apia necesita confirmar una cuenta empresarial. En todos los casos el trabajo es el mismo: demostrar que un usuario con +685 puede completar tu flujo de registro.
¿Cómo se debe tratar un número +685 en el código?
Los números nacionales de Samoa son cortos en comparación con la mayoría de los mercados, por lo que los validadores pensados para números de nueve o diez dígitos pueden rechazar uno real. Guarda los números como +685 más los dígitos nacionales, sin separadores, y elimina el cero que un usuario añada por costumbre. Como las marcas de tiempo de los webhooks son segundos Unix, compáralas en UTC y no en hora local; así evitas sorpresas cuando tu servidor y un tester en Samoa están en días distintos del calendario.
Si tu producto permite alternar entre un número de Nueva Zelanda y uno de Samoa en el mismo perfil, añade una prueba que cambie el prefijo del país y confirme que el estado de verificación anterior se borra, de modo que un código enviado a un número nunca se acepte para el otro.
¿Qué servicios están disponibles en las rutas de Samoa?
El catálogo de Samoa incluye actualmente más de 600 servicios. Entre los más solicitados están WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), Viber, Signal, TikTok, Microsoft & Outlook, Amazon y Discord. La cobertura es menor que en los grandes mercados y cambia a lo largo del día, así que consulta GET /api/v1/services y GET /api/v1/countries antes de cada ejecución. Si falta un servicio, una ruta vecina como Fiyi o Tonga puede servir para tu prueba.
Un catálogo más reducido es buen motivo para que tu entorno de pruebas sea tolerante: si el servicio preferido no está disponible en el momento de la ejecución, marca el caso como omitido en lugar de fallido y regístralo para que alguien pueda reintentarlo más tarde.
Cómo pedir un código de Samoa mediante la API
Con una clave Bearer (or_live_…) sobre https://otproute.com/api/v1, consulta el precio con GET /api/v1/prices?country=ws&service=<id> y luego envía {"service": "<id>", "country": "ws"} a POST /api/v1/activations. Sigue el id de la activación consultando GET /api/v1/activations/{id} o escuchando activation.sms_received. Verifica el HMAC de X-OTPRoute-Signature en cada webhook, rechaza las marcas de tiempo antiguas y haz que el manejador sea seguro si se ejecuta dos veces para la misma activación. La guía de integración muestra el esquema completo.
Los límites son holgados para un mercado de este tamaño: cada cuenta dispone de hasta 10 claves, 5 endpoints de webhook y 300 solicitudes por minuto. Si haces polling, con unos segundos entre consultas es más que suficiente.
Hacerlo a mano desde el panel
- Inicia sesión y abre el OTP Gateway.
- Elige el servicio y después Samoa.
- Revisa el precio en vivo y confirma.
- Pega el número +685 en la aplicación que estás probando y solicita el código.
- Lee el código en pantalla o cancela si ya no lo necesitas.
Cuando un código +685 tarda o no llega
Mantén la activación abierta los 20 minutos completos antes de darte por vencido. Algunas aplicaciones rechazan por completo los números virtuales, y por eso se reembolsan los pedidos sin respuesta. Si una ruta permanece en silencio, prueba más tarde o elige otra ruta de servicio; lanzar pedidos nuevos en bucle rápido rara vez ayuda y consume tu límite de solicitudes.
Registra el id de la activación en cada intento para poder ver si el silencio viene de una aplicación concreta o de la ruta en su conjunto.
Números de larga duración y forma de pago
OTP Route no vende un número samoano de larga duración en modalidad de autoservicio. Los Números Dedicados empiezan desde $1.95/month y se limitan a Estados Unidos y Canadá; para una línea de Samoa, escribe a [email protected], sin promesa de que pueda gestionarse. El monedero prepago en USD admite tarjetas y USDT/USDC, envía una factura en PDF por cada recarga y no tiene cuota mensual. Solicita el modo sandbox en una cuenta de desarrollo para ensayar el flujo ws sin gastar fondos.
Preguntas frecuentes
¿Samoa es lo mismo que Samoa Americana en cuanto a números de teléfono?
No. Samoa usa +685, mientras que Samoa Americana usa +1 684. Elige el correcto en tu selector de países y en la API.
¿Cuál es el id de país de Samoa en la API?
Usa ws en la consulta de precios y en la solicitud de activación.
¿Cuánto cuesta un código de verificación de Samoa?
Desde $0.20 por código; el precio exacto depende del servicio y se muestra antes de pedir.
¿Puedo probar el registro de un usuario samoano desde Nueva Zelanda o Australia?
Sí. El número +685 recibe el SMS y OTP Route te lo muestra desde donde trabaje tu equipo.
¿Pago si no llega ningún mensaje?
No. Las activaciones caducadas o canceladas se reembolsan automáticamente al monedero.
¿En qué idiomas llegan los códigos de Samoa?
Normalmente en inglés, que es oficial junto con el samoano. Analiza los dígitos, no el texto que los rodea.
¿Puedo usar estos números para abrir muchas cuentas?
No. Respeta las condiciones de cada servicio; la Política de Uso Aceptable limita OTP Route a probar y operar tus propias cuentas y productos legítimos.
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.