>otpfactory.io

API

REST API para solicitar números virtuales, consultar SMS, administrar rentas y recargar la cartera. Los mismos endpoints que usa el panel — autenticación bearer-token, JSON entrada y salida, sin SDK requerido.

Autenticación

Genera un token API personal desde Panel → Tokens API. Inclúyelo como header bearer en cada solicitud:

Authorization: Bearer <your-token>

URL base

https://api.otpfactory.com

Endpoints

  • GET/v1/servicesLista servicios soportados con precios actuales por país.
  • GET/v1/countriesLista países con inventario activo.
  • POST/v1/ordersapiPage.endpoints.items.createOrder
  • GET/v1/orders/:idapiPage.endpoints.items.getOrder
  • DELETE/v1/orders/:idCancela una orden activa. Reembolsa la cartera si no hay SMS aún.
  • POST/v1/paymentsapiPage.endpoints.items.createPayment
  • GET/v1/walletObtén saldo actual de cartera y transacciones recientes.
  • GET/v1/rentalsLista rentas activas a largo plazo.

Inicio rápido

curl -X POST https://api.otpfactory.com/v1/orders \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"serviceSlug":"telegram","countryIso":"US"}'

Límites de tasa

  • • Colocación de órdenes: 30 solicitudes / minuto / token
  • • Consulta de órdenes: 120 solicitudes / minuto / token
  • • Pagos / depósitos: 10 solicitudes / hora / token
  • • Fallback global por IP: 120 solicitudes / minuto (aplica incluso sin token)

Al alcanzar un límite retorna HTTP 429 con un header Retry-After.

¿Necesitas un límite mayor?

Contacta @otpfactory_support con tu caso de uso. Planes reseller e integración obtienen 10x presupuesto de ráfaga en endpoints de órdenes.