Probar flujos de verificación +27: lista de comprobación para lanzamientos en Sudáfrica

Antes del primer pedido +27: una breve lista de preparación

Marca estos puntos y tu primera activación en Sudáfrica debería funcionar sin sorpresas:

1. Monedero recargado. Un único monedero prepago en USD financia todo; cárgalo con tarjeta o con USDT/USDC. No hay ninguna suscripción.
2. Clave emitida. Genera una clave Bearer en la consola de desarrollador (empieza por or_live_). Mantén claves separadas para CI y para staging, hasta 10 en total.
3. Webhook registrado. Añade un endpoint HTTPS y guarda su secreto de firma. Puedes registrar hasta cinco.
4. Normalizador de números probado. Aliméntalo con entradas del estilo 082 123 4567 y confirma que produce +2782... sin el 0 inicial.
5. Id de servicio confirmado. Obtén el catálogo con GET /api/v1/services en lugar de adivinar los ids.
6. Sandbox opcional. El soporte puede cambiar una cuenta de desarrollo a sandbox para que números y códigos simulados pasen por tu código antes de cualquier gasto real.

La guía de pruebas en CI muestra cómo integrar estas piezas en un pipeline.

¿Cómo deben guardarse y normalizarse los números sudafricanos?

Sudáfrica usa el prefijo troncal 0. Un móvil escrito en formato local tiene diez dígitos, como 082 123 4567, y los rangos móviles suelen empezar por 06, 07 u 08 en esa forma nacional. En formato internacional el 0 desaparece: la misma línea pasa a ser +27 82 123 4567, o +27821234567 una vez quitados los espacios, es decir, nueve dígitos después del prefijo del país.

El error clásico es un valor guardado como +270821234567, que se produce cuando un formulario pega el prefijo del país al número local sin quitar el 0. Normaliza al introducir, guarda solo E.164 y muestra el formato local con espacios únicamente para presentación. Si envías SMS salientes por tu cuenta, la misma regla mantiene coherentes los informes de entrega y las búsquedas de usuarios.

¿Qué servicios pueden enviar códigos a un número de verificación de Sudáfrica?

Entre las rutas populares para za ahora mismo están WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Uber, Telegram, Microsoft & Outlook, LinkedIn, Netflix, Amazon, X (Twitter), ChatGPT (OpenAI) y Discord. En todo el catálogo, el país admite más de 1,700 servicios y, como el inventario se mueve durante el día, la API es el lugar donde leer la disponibilidad actual.

¿Por qué eligen este mercado los equipos? Johannesburgo y Ciudad del Cabo son centros consolidados de tecnología y finanzas, y muchas empresas usan Sudáfrica como base para un despliegue más amplio en el sur de África. El país tiene varios idiomas oficiales, entre ellos inglés, isiZulu, isiXhosa y afrikáans, aunque la mayoría de los mensajes de verificación llegan en inglés, por lo que el QA de localización suele centrarse en las pantallas que rodean al SMS más que en el texto del SMS.

Pasos: llamar a la API OTP de Sudáfrica desde tu entorno de pruebas

Las solicitudes van a https://otproute.com/api/v1 con tu clave Bearer, hasta 300 por minuto.

1. GET /api/v1/prices?country=za&service=<id> devuelve el precio en vivo para la combinación que quieres.
2. POST /api/v1/activations con {"service": "<id>", "country": "za"} reserva un número +27 y devuelve un id de activación.
3. Tu prueba introduce el número en la app y dispara el SMS.
4. El evento activation.sms_received llega a tu webhook. Antes de fiarte de él, reconstruye el HMAC-SHA256 de <t>.<raw body> con el secreto del endpoint, compáralo con v1 en X-OTPRoute-Signature y descarta las solicitudes cuya marca de tiempo sea demasiado antigua.
5. ¿Prefieres polling? Lee GET /api/v1/activations/{id} con un intervalo moderado.
6. Las ejecuciones abandonadas deben llamar a POST /api/v1/activations/{id}/cancel, y GET /api/v1/balance permite que un trabajo se detenga pronto cuando los fondos escasean.

Más información sobre las opciones de enrutamiento en enrutamiento por país para OTP.

Pasos para el personal de operaciones que usa el panel

No se necesita código: abre OTP Gateway, elige Sudáfrica y el servicio, comprueba el precio mostrado, confirma y pega el número +27 en la app. El SMS aparece en la página de la activación según llega, y la ventana de 20 minutos y el reembolso automático funcionan exactamente igual que a través de la API.

Solución de problemas con códigos sudafricanos retrasados

Primero, el dinero: si no llega ningún SMS en 20 minutos, o cancelas, el importe completo vuelve al monedero automáticamente. Después, diagnostica:

• Paciencia primero. La velocidad de entrega depende del servicio y de la ruta, así que deja que la activación siga su curso.
• Política de aceptación. Algunos servicios rechazan los números virtuales; un reembolso en ese caso es el comportamiento esperado, no un fallo.
• Otra hora u otra ruta. Inténtalo más tarde o usa una ruta vecina como Namibia o Botsuana cuando el caso de prueba lo permita.
• Sin martillear. Cancelar y volver a pedir en un bucle apretado rara vez ayuda y consume tu límite de solicitudes.

Usa los números solo para probar tu propio producto o gestionar tus propias cuentas de empresa, respeta las condiciones de cada servicio y ten presente que se aplica la Política de Uso Aceptable de OTP Route.

Líneas sudafricanas de larga duración y modelo de facturación

No existe un número +27 de larga duración de autoservicio. Los números dedicados, desde $1.95/mes, se ofrecen solo en Estados Unidos y Canadá; los equipos que necesiten una línea sudafricana permanente pueden escribir a [email protected], y que sea posible depende de la normativa local. La facturación es por uso desde el monedero prepago, con una factura en PDF enviada por correo por cada recarga. Consulta precios para ver el panorama completo.

Preguntas frecuentes

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

Sí. Pide un número +27 a través de OTP Gateway y lee el código en el panel o por la API. Cuesta desde $0.20 por código, y solo cuando llega el código.

¿Conservo el 0 inicial al convertir un número sudafricano a E.164?

No. Elimina el 0 troncal y añade el prefijo +27, de modo que 082 123 4567 pasa a ser +27821234567.

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

Es za, que va en la consulta de precios y en el cuerpo JSON al crear una activación +27.

¿En qué idioma llegan los textos de verificación de Sudáfrica?

Sobre todo en inglés, aunque el país tiene varios idiomas oficiales. La redacción la decide el servicio emisor.

¿Hay reembolso si el código nunca se entrega?

Sí. La activación está abierta 20 minutos y, si no llega nada o cancelas, el importe completo vuelve automáticamente a tu monedero.

¿Puedo comprar un número sudafricano para conservarlo durante meses?

No en autoservicio. Los números dedicados son un producto de EE. UU. y Canadá; para Sudáfrica, escribe a soporte para consultarlo, sin promesa de disponibilidad.

¿Cuántos servicios puedo verificar con un número +27 en OTP Route?

Más de 1,700 en la última instantánea. Consulta el catálogo en vivo a través de la API, ya que la disponibilidad cambia durante el día.

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.