StreamZone Developer API — Documentación Oficial B2B

Inicio Rápido en 3 Pasos

1. Obtén tu Clave Secreta (API Key)

Entra a tu portal de revendedor o en nuestro bot oficial de Telegram (@streamzone_oficial_bot) y pulsa en "🔌 Conectar mi Tienda / API". Recibirás tu clave secreta personal con el prefijo sz_live_....

2. Recarga saldo a tu Billetera (Wallet)

La API no requiere tarjetas de crédito recurrentes. Realiza compras en piloto automático debitando de tu wallet mayorista mediante Binance Pay (USDT Directo), Criptomonedas (Plisio) o Transferencia Bancaria / PSE.

3. Realiza tu primera llamada HTTP

BASH / CURL

curl -X GET "https://streamzone.app/api/v1/profile" \
  -H "Authorization: Bearer sz_live_TU_CLAVE_AQUI" \
  -H "Content-Type: application/json"

Autenticación y Seguridad

Todas las llamadas a la API requieren que envíes tu clave en la cabecera estándar HTTP Authorization con el esquema Bearer.

HTTP HEADER

Authorization: Bearer sz_live_9f81a7b6c5d4e3f2...

⚠️ Regla de Seguridad: Tu Clave API nunca debe exponerse en el frontend o código cliente del navegador. Debe usarse exclusivamente en tu servidor o bot backend. Si expones tu clave por error, puedes rotarla o revocarla de inmediato desde tu panel o desde Telegram.

Modelo Financiero de Billetera

Las órdenes vía API operan en modo débito atómico: el backend valida en milisegundos que tu billetera cuente con el saldo requerido para la compra. Si tienes saldo suficiente, el inventario se bloquea, se genera la orden y se entregan las credenciales en la misma respuesta HTTP. Si no cuentas con saldo, recibirás un error 402 Payment Required.

Referencia de Endpoints

GET /api/v1/profile

Consulta la información de tu cuenta, tu saldo disponible en pesos colombianos (COP) y dólares (USD), y el estado de tu conexión API.

EJEMPLO DE RESPUESTA (200 OK)

{
  "ok": true,
  "data": {
    "userId": "usr_demo_8f92a10b4c",
    "name": "Distribuidor Demo",
    "email": "revendedor@ejemplo.com",
    "role": "RESELLER",
    "wallet": {
      "balanceCOP": 150000,
      "balanceUSD": 38.50,
      "currency": "COP",
      "formattedCOP": "$150.000 COP",
      "formattedUSD": "$38.50 USD"
    },
    "webhookUrl": "https://mi-tienda.com/api/webhook",
    "apiStatus": "ACTIVE"
  }
}

GET /api/v1/catalog

Retorna la lista de todos los servicios activos disponibles para revender, con su precio de mayorista, stock disponible en tiempo real y duración.

EJEMPLO DE RESPUESTA (200 OK)

{
  "ok": true,
  "total": 48,
  "exchangeRateUSDToCOP": 3182.78,
  "products": [
    {
      "id": "1c1c09da-3ef2-43e5-9ad8-91d84880bbb9",
      "code": "B2C-FTR5BMJAOR",
      "name": "Netflix Premium",
      "category": "Streaming",
      "durationDays": 30,
      "priceCOP": 11000,
      "priceUSD": 3.46,
      "inStock": true,
      "stockAvailable": 18,
      "origin": "STREAMZONE_BODEGA"
    }
  ]
}

POST /api/v1/orders

Compra y entrega instantánea de credenciales. Debita el saldo mayorista de tu wallet y entrega las credenciales de acceso directamente en la respuesta JSON.

Parámetro	Tipo	Obligatorio	Descripción
productId	String	SÍ	ID único del producto obtenido en el catálogo.
quantity	Integer	No (default: 1)	Cantidad de perfiles o licencias a comprar (máximo 10 por llamada).
idempotencyKey	String	Recomendado	Identificador único para evitar cobros dobles si tu servidor reintenta la petición.

EJEMPLO REQUEST BODY (JSON)

{
  "productId": "1c1c09da-3ef2-43e5-9ad8-91d84880bbb9",
  "quantity": 1,
  "idempotencyKey": "mi-orden-bot-10492"
}

EJEMPLO DE RESPUESTA (200 OK) — CREDENCIALES ENTREGADAS

{
  "ok": true,
  "orderId": "ORD-API-1792289512-881",
  "status": "COMPLETED",
  "product": {
    "id": "1c1c09da-3ef2-43e5-9ad8-91d84880bbb9",
    "name": "Netflix Premium",
    "durationDays": 30
  },
  "credentials": [
    {
      "email": "netflix_premium22@streamzone.app",
      "password": "ZonePass2026*",
      "profile": "Perfil 3",
      "pin": "4819",
      "expiresAt": "2026-11-18T05:00:00.000Z"
    }
  ],
  "financial": {
    "chargedCOP": 11000,
    "balanceBeforeCOP": 45000,
    "balanceAfterCOP": 34000,
    "currency": "COP"
  }
}

GET /api/v1/orders

Consulta el historial de órdenes realizadas con tu Clave API o re-obtiene los datos de una orden específica con el parámetro ?orderId=ORD-API-....

Webhooks Salientes (Alertas de Precios)

Configura una URL de Webhook en tu perfil y nuestro servidor enviará automáticamente una petición HTTP POST cada vez que se actualice o baje el precio de un servicio en la plataforma:

PAYLOAD ENVIADO A TU WEBHOOK

{
  "event": "price.updated",
  "timestamp": "2026-10-18T05:22:10.000Z",
  "data": {
    "productId": "1c1c09da-3ef2-43e5-9ad8-91d84880bbb9",
    "productName": "Netflix Premium",
    "oldPrice": 12000,
    "newPrice": 11000,
    "difference": -1000,
    "currency": "COP"
  }
}

Códigos de Error HTTP