Saltar al contenido principal

Portal de Partners

El Portal de Partners permite a ISVs y resellers administrar múltiples tenants de OmniBuy desde una sola interfaz, con capacidad de impersonar a cualquier tenant para brindar soporte o realizar configuraciones.

¿Para quién es esto?​

  • ISVs que construyen soluciones sobre OmniBuy
  • Agencias que administran tiendas para sus clientes
  • Resellers que ofrecen OmniBuy bajo su propia marca (white-label)

Acceso al portal​

El portal vive en:

https://admin.omnibuy.net/partner/login

Tus credenciales de partner te las proporciona el equipo de OmniBuy. Una vez dentro, verás el dashboard con todos los tenants asociados a tu cuenta.

Autenticación​

Login​

POST /partner/login
Content-Type: application/json

{
  "email": "partner@empresa.com",
  "password": "tu-password"
}

Respuesta exitosa (200):

{
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "partner_id": "uuid-partner",
    "name": "Empresa Partner SAC"
  }
}

Logout​

GET /partner/logout

Revoca la sesión activa y redirige al login.

Impersonar un tenant​

La funcionalidad más poderosa del portal es la impersonación: obtienes un JWT temporal (1 hora) con scope completo de admin para un tenant específico, sin necesitar las credenciales del merchant.

POST /partner/impersonate/:tenant_id
Authorization: Bearer <partner_token>

Respuesta (200):

{
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "tenant_id": "uuid-tenant",
    "expires_in": 3600,
    "scope": "admin"
  }
}

Usa este token en el header Authorization: Bearer <impersonation_token> para cualquier llamada a la API del tenant durante esa hora.

Seguridad

Los tokens de impersonación son de un solo uso por sesión y expiran en 60 minutos. Nunca los almacenes en bases de datos ni los compartas. Toda impersonación queda registrada en el audit log del tenant.

Dashboard del partner​

El dashboard en GET /partner/dashboard lista todos los tenants con:

  • Nombre y dominio del tenant
  • Plan activo (Free / Starter / Growth / Pro)
  • Estado (activo / suspendido / trial)
  • Fecha de último acceso
  • Botón de acceso directo (impersonación con un clic)

White-label​

Si tienes un acuerdo white-label, puedes personalizar OmniBuy con tu propia marca para tus clientes:

ConfiguraciónDescripción
LogoReemplaza el logo de OmniBuy en el admin panel
ColoresColor primario y de acento (hex)
Dominio customadmin.tu-empresa.com en lugar de admin.omnibuy.net
Nombre de plataformaAparece en emails transaccionales y en el UI

La configuración white-label se aplica por partner y afecta a todos los tenants que gestionas.

Para activar white-label, contacta a partners@omnibuy.net.

Seguridad y auditoría​

  • Toda impersonación queda registrada con timestamp, IP, partner_id y tenant_id
  • Los merchants pueden ver el log de impersonaciones en Configuración → Seguridad → Accesos de partner
  • Puedes revocar el acceso de un partner desde el mismo panel