Todos los artículos

getNumber, getStatus, setStatus 3/6/8: dónde pierde dinero el ciclo de activación

El bot pidió un número, a los 30 segundos no vio ningún SMS, envió setStatus 8 y pasó al siguiente. El servidor rechazó la cancelación, pero nadie leyó la respuesta. Más tarde llegó un código a ese primer número. El pedido quedó pagado y el código nunca se usó. Abajo está el ciclo de activación por API paso a paso, junto con las ramas en las que una integración acaba pagando por códigos que no necesita.

El ciclo, paso a paso

  1. getNumber. El bot pide un número para un servicio y un país, el importe del pedido se reserva en tu saldo y la respuesta trae un id de activación. Guarda el id en un almacenamiento persistente antes de que el bot introduzca el número en el servicio. Si el proceso se cae, sin el id no puedes cancelar el pedido ni recoger el código.
  2. getStatus. El bot consulta el estado y espera el código. El catálogo fija cuánto esperar: cada servicio tiene su propia ventana, ahora mismo de una hora.
  3. setStatus 3. Necesitas otro código en el mismo número: el primero no sirvió o el servicio te pide confirmar otra vez. Después del 3, el bot vuelve a consultar getStatus.
  4. setStatus 6. El código se ha usado y el pedido está completado.
  5. setStatus 8. Cancelación. Solo se acepta mientras el código no ha llegado y cuando ha pasado al menos un minuto desde la compra.

Si el bot no hace nada y no llega ningún código, la reserva vuelve sola a tu saldo cuando la ventana expira. De ahí sale la regla principal de la integración: cancelar una activación con setStatus 8 solo te da un reembolso antes de que llegue el código. Una vez recibido el SMS, el servicio se considera prestado y el pedido no se reembolsa. Todos los reembolsos van a tu saldo interno, no a una billetera.

Dónde se pierde el dinero

Cancelar en el primer minuto. Es el escenario del principio. Lee la respuesta a cada setStatus 8. Si la cancelación falló por la regla del minuto, sigue consultando getStatus y repite la cancelación cuando haya pasado un minuto desde la compra.

Carrera entre el sondeo y la cancelación. getStatus devolvió «esperando», el bot envió 8 y el código llegó entre las dos peticiones. La cancelación ya no se aceptará. Haz una llamada más a getStatus y usa el código. El pedido está pagado de todos modos.

Cancelar después del código porque el registro falló. El servicio rechazó la cuenta, así que el desarrollador envía 8 y espera recuperar el dinero. El código se entregó, lo que significa que el servicio se prestó, y recibir un SMS no garantiza un registro correcto en un servicio externo. Cierra estos pedidos con el estado 6 y cuéntalos en tus informes aparte de las cancelaciones.

Número abandonado. El bot pasa al siguiente número sin cancelar, a menudo por un único timeout compartido entre todos los servicios. Si el timeout es más corto que la ventana del servicio, el código puede llegar cuando el bot ya ha dejado de esperar, y habrás pagado para nada. Toma el timeout de la ventana del servicio concreto y cierra con un estado 8 explícito cualquier número que ya no necesites.

Un número nuevo en lugar del estado 3. El primer código no sirvió, así que el bot compra otro número. Un nuevo getNumber es un pedido aparte con su propia reserva, y el registro en el servicio tiene que empezar de cero. Pide un código repetido con el estado 3 en el mismo número y comprueba que getStatus devolvió un código nuevo, no el anterior.

Éxito sin cerrar. El código se introdujo, pero el 6 nunca se envió. El pedido sigue abierto hasta que se acaba la ventana, y el log ya no permite distinguir qué números están terminados y cuáles siguen esperando un código. Envía el 6 en cuanto el servicio acepte el código.

Migración desde otro servicio. Si el bot se pasó a nosotros cambiando la URL base, sus ramas de estados se escribieron para las reglas de la plataforma anterior. Comprueba la espera de un minuto antes de cancelar y fija los timeouts según las ventanas de nuestro catálogo.

Sondeo, claves y softId

El límite de la API es de 600 peticiones por minuto por clave. Son diez por segundo entre todos tus pedidos abiertos. Un bucle de getStatus sin pausas lo alcanza rápido. El caso más peligroso es cuando tu código interpreta un rechazo por límite de peticiones como «todavía no hay código» y cancela o abandona el número. Consulta cada pedido con una pausa de unos segundos y trata la respuesta de límite de peticiones en una rama propia: esperar y después reintentar.

Las compras hechas con una clave de API se cobran de tu saldo. Emite una clave con nombre aparte para cada bot o entorno. La fecha de la última solicitud en el panel muestra qué claves sobran, para que puedas revocarlas.

Para dueños de software del programa de socios: asegúrate de que softId se envía con cada getNumber. Sin él, la compra no quedará vinculada a tu software_id y no recibirás el 5% de la activación del usuario. Si un pedido se reembolsa, la comisión de ese pedido se descuenta.

Qué revisar hoy

Abre la «Documentación de la API» en tu panel y compara con ella cómo tratas cada estado, empezando por la respuesta al 8 y por los timeouts basados en la ventana de cada servicio. Después elige un periodo en el «Historial de saldo» y coteja los reembolsos con el log del bot. Cada pedido cancelado o expirado sin código debe volver a tu saldo. Si el log muestra una cancelación pero en el «Historial de saldo» solo hay un pago por ese pedido, busca el número en el «Historial» y comprueba cuándo envió el bot el 8: en el primer minuto o cuando el código ya había llegado.

Tu primer número en un minuto

Registrarse lleva un minuto, recargar un par más, y el código llega en 20 segundos.

Comprar número
Sin cuota mensualCancelación con reembolso en la primera hora