API de Verificación SMS para Desarrolladores

SIM real de EE. UU. vende números con SIM física que conservas durante días. La compra va en cola, así que un operador lento nunca agota el tiempo de tu petición:

• get-services — todas las opciones; cada periodo de validez tiene su propio product_id, price y stock.
• request-number — product_id y, opcional, quantity (1–100). Cobra al momento y responde con order_ids y status: "pending". 402 si el saldo no alcanza.
• get-order-status — order_ids (separados por comas, hasta 100). pending mientras conseguimos el número; luego ready con number, expires_at y un share_link, o failed con error — un número fallido se reembolsa automáticamente.
• get-numbers (status=active|all) y get-messages (order_id) — todos los SMS, del más reciente al más antiguo, con el code extraído.
• renew-number — order_ids; cobra la renovación al momento y amplía cada número activo un periodo más, normalmente en pocas horas. get-numbers muestra renewal: "pending" hasta que se aplica; si no se aplica en 3 días se reembolsa automáticamente.
• Un número entregado no es reembolsable. Compra uno primero al probar un servicio.
• Webhooks: order.number_assigned cuando el número está listo, sms.received por cada SMS, order.failed + order.refunded si no se pudo entregar; llevan "provider": "us-real-sim".

Temp (s2) funciona como Temp (s1), con dos opciones más en request-number:

• service_key — obligatorio; el service_key de tn102/get-services.
• carrier — opcional, at&t o tmobile. Con keep_carrier: true el pedido falla en lugar de usar otro operador.
• area_codes — opcional, separados por comas, p. ej. "212,305"; tn102/get-area-stock?service_key=… muestra el stock. Con lock_area_code: true el pedido falla en lugar de usar otro código.
• Cada opción suma el recargo que devuelve get-services. Un pedido fallido nunca se cobra.
• request-multiple — service_keys (2–7, separados por comas o en un array) y las mismas opciones carrier / area_codes: un número para todos, un pedido por servicio. Todo o nada: si un servicio no cabe en el número, no se cobra ninguno.
• request-specific-number — number (10 dígitos de EE. UU.) y service_key: ese número exacto, por el precio del servicio más un recargo. No se cobra nada si no está disponible.
• reject-number funciona a partir de cinco minutos tras la compra. Antes responde 409 con data.retry_after_seconds.
• Consulta get-number-details; code contiene el código cuando llega. Los números sin usar se reembolsan solos al caducar.

Alquiler reserva un número para un servicio durante un periodo:

• request-number — service_key y period (1d, 3d, 7d, 14d o 30d), obligatorios; opcionales area_codes, lock_area_code, auto_renew. Devuelve rental_id.
• get-messages / get-rental-details — rental_id; todos los mensajes recibidos, del más reciente al más antiguo, con el código extraído.
• renew-rental — rental_id; cobra el precio actual del mismo periodo y amplía la fecha de fin. 402 si el saldo no alcanza.
• set-auto-renew — rental_id, auto_renew (true/false); renueva con el saldo poco antes del final.
• cancel-rental — rental_id; reembolsa completo solo mientras no haya llegado ningún mensaje.

Los eventos de ambos llegan a tus webhooks como los de cualquier pedido; los de alquiler llevan "provider": "s2-rental".