Recibe códigos OTP por SMS de Nueva Zelanda por API o desde el panel

¿Número temporal +64 o línea de largo plazo: cuál necesito?

Elegir primero el producto adecuado evita rehacer trabajo después.

Elige el OTP Gateway cuando una prueba o un paso de alta necesita exactamente un código: una cuenta de QA nueva, una prueba rápida de tu pantalla de registro para Nueva Zelanda, una comprobación de que el flujo de un cliente kiwi funciona de punta a punta. Recibes un número, un código y la sesión se cierra.

Elige un Número Dedicado cuando la misma cuenta debe volver a iniciar sesión semanas después o un equipo comparte un número de recuperación. Esas líneas de largo plazo se ofrecen solo en Estados Unidos y Canadá, desde $1.95/month, con los SMS entrantes reenviados como eventos number.sms_received.

Para Nueva Zelanda no existe un número de largo plazo de autoservicio. Escribe a [email protected] si tu caso necesita uno; la respuesta depende de la normativa local y puede ser negativa. Las llamadas, los SMS salientes y las condiciones de renovación de esas líneas norteamericanas están en la página de números virtuales.

¿Por qué los equipos de producto prueban registros en Nueva Zelanda?

Nueva Zelanda es un mercado habitual de lanzamiento suave para apps en inglés: una audiencia más pequeña, un idioma conocido y una zona horaria temprana lo convierten en un lugar práctico para observar el alta real de usuarios antes de un lanzamiento más amplio. Eso significa que el paso de verificación +64 suele ser la primera ruta de producción que ve un mercado nuevo, y merece sus propios casos de prueba.

Conviene cubrir varios puntos:

• Idioma. El inglés, el te reo maorí y la lengua de señas de Nueva Zelanda son oficiales. La mayoría de los servicios envía los códigos en inglés, pero si tus propias plantillas usan palabras maoríes con macrones (ā, ō, ū), esos caracteres quedan fuera de GSM-7 y llevan el SMS a UCS-2, lo que acorta cada segmento.
• Bordes del reloj. Nueva Zelanda es de los primeros lugares en llegar a un nuevo día del calendario, así que la lógica de caducidad y de límites de frecuencia basada en fechas puede comportarse distinto para los usuarios locales.
• Ajuste al mercado. Una cuenta de QA verificada con un número local ejercita la misma lógica de país que encontrarán tus usuarios kiwis.

Para un patrón de control previo al lanzamiento basado en comprobaciones como estas, consulta nuestras notas de pruebas de QA.

¿Cómo se deben guardar y normalizar los números móviles +64?

Nueva Zelanda usa el 0 como prefijo troncal. Un móvil escrito a nivel nacional como 021 123 4567 pasa a ser +64211234567 en E.164: se quita el 0 inicial y se añade +64. Los rangos móviles empiezan por 2 una vez eliminado el cero y su longitud varía, así que nunca fijes una cantidad única de dígitos.

Reglas prácticas para tu esquema:

• Guarda una sola cadena E.164 canónica; da formato solo al mostrarla.
• Acepta entradas con espacios, guiones o el cero troncal, y normalízalas con una biblioteca de análisis telefónico mantenida.
• Añade casos de prueba tanto para la grafía nacional como para la internacional, y también para un número que el usuario pegó con +64 y con el 0 todavía puesto.

¿Qué apps envían códigos a números de Nueva Zelanda en OTP Route?

La ruta +64 cubre más de 800 servicios. Según la instantánea actual, entre los de uso frecuente están Google (Gmail & YouTube), WhatsApp, Telegram, Facebook, Instagram, TikTok, ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Discord, Snapchat, LinkedIn, Uber y Netflix.

Como la disponibilidad es en vivo, consulta GET /api/v1/countries y GET /api/v1/services al inicio de cada ejecución en lugar de guardar una lista durante semanas. Si un servicio tiene poca presencia en +64, la ruta vecina de Australia es el recurso habitual para una comparación en inglés.

¿Cómo es la secuencia de la API OTP de Nueva Zelanda?

Cada llamada +64 va a https://otproute.com/api/v1 con una clave Bearer or_live_ emitida en la consola de desarrolladores. La secuencia:

1. Lee el precio en vivo con GET /api/v1/prices?country=nz&service=uber.
2. Crea la activación con POST /api/v1/activations y el cuerpo {"service": "uber", "country": "nz"}.
3. Obtén el código consultando GET /api/v1/activations/{id}, o deja que activation.sms_received llegue a tu webhook. activation.expired y activation.cancelled te avisan cuándo limpiar.
4. Cancela los pedidos sin usar con POST /api/v1/activations/{id}/cancel y vigila los fondos con GET /api/v1/balance.

En los webhooks, verifica X-OTPRoute-Signature calculando HMAC-SHA256 de <t>.<raw body> con el secreto del endpoint, rechaza las marcas de tiempo antiguas y haz que el manejador sea idempotente respecto al id de activación, de modo que una entrega repetida no cause daño. La guía de integración ofrece un recorrido más completo; el límite es de 300 solicitudes por minuto por cuenta.

¿Puede una persona sin perfil técnico pedir un número de verificación de Nueva Zelanda?

Por supuesto. En el panel, elige Nueva Zelanda, selecciona el servicio, revisa el precio mostrado y confirma. El número +64 aparece en el pedido; escríbelo en la app, solicita el SMS y el código aparece en la misma tarjeta cuando llega. Todo ocurre dentro de la ventana de 20 minutos, así que ten abierta la app de destino antes de hacer el pedido.

¿Qué hago si el código +64 nunca aparece?

Primero dale a la ventana sus 20 minutos completos, porque algunos remitentes retrasan o agrupan sus SMS. Si sigue vacía, puede que el servicio rechace los números virtuales o que esa ruta esté saturada; reintenta más tarde o prueba con otra ruta de servicio en lugar de lanzar pedidos nuevos uno tras otro. Los pedidos sin respuesta, y los que cancelas, se reembolsan a la billetera de forma automática. La facturación es de pago por uso desde una billetera prepagada en USD: recargas con tarjeta o con USDT/USDC, una factura en PDF por cada una, sin cuota mensual y con modo sandbox a petición para ensayos. OTP Route es para tus propias cuentas y productos legítimos, conforme a las condiciones de cada servicio y a nuestra Política de Uso Aceptable.

Preguntas frecuentes

¿Puedo probar el flujo de registro de mi app en Nueva Zelanda sin una SIM local?

Sí. Pide un número +64 en el OTP Gateway, úsalo en tu formulario de registro y lee el código en el panel o a través de la API.

¿Conservo el 0 al guardar un móvil de Nueva Zelanda?

No. El 0 troncal se elimina en E.164, así que 021 123 4567 se guarda como +64211234567.

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

Es nz, y se usa tanto en las consultas de precio como en el cuerpo de la solicitud de activación.

¿Cuánto cuesta un código de verificación de Nueva Zelanda?

Los precios empiezan en $0.20 por código y dependen del servicio; el panel y GET /api/v1/prices muestran la cifra exacta antes de pedir.

¿Puedo alquilar un número de Nueva Zelanda por unos meses?

No hay una línea +64 de largo plazo de autoservicio. Los Números Dedicados son un producto de EE. UU. y Canadá, y puedes escribir a [email protected] para consultar por otros países.

¿Es mejor la consulta periódica o un webhook para recoger los códigos +64?

La consulta periódica es más sencilla para un solo script; un webhook firmado escala mejor cuando se ejecutan muchas pruebas en paralelo. Ambos devuelven el mismo código.

¿Aceptará toda app un número de Nueva Zelanda de OTP Route?

No necesariamente. Algunos servicios rechazan los números virtuales, y por eso un pedido sin SMS se reembolsa automáticamente.

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.