Portal del Cliente

Página de autoservicio donde los clientes gestionan su suscripción, ven su uso, cambian de plan y compran créditos. Se crea automáticamente con cada suscripción.

Qué pueden hacer los clientes

• Ver la suscripción actual y el ciclo de cobro
• Ver el uso de todas las features
• Hacer upgrade o downgrade de plan (requiere un Plan Group)
• Comprar Credit Packs, top-ups de balance y Add-ons
• Actualizar método de pago y datos de cobro
• Ver el historial de recibos
• Cancelar la suscripción

Las compras están disponibles en suscripciones activas, en trial y en planes gratuitos. A los clientes en planes gratuitos se les pide agregar un método de pago en su primera compra.

Generar la URL del portal

Las URLs del portal son de un solo uso y expiran después de 2 horas de inactividad. Genera una URL nueva en cada request.

const portal = await commet.portal.getUrl({ customerId: 'user_123' })

redirect(portal.data.portalUrl)

portal = commet.portal.get_url(customer_id='user_123')

redirect(portal.data['portal_url'])

portal, err := client.Portal.GetURL(ctx, &commet.GetPortalURLParams{
    CustomerID: "user_123",
})

// redirect(portal.Data.PortalURL)

ApiResponse<PortalSession> portal = commet.portal().getUrl("user_123", null, null);

// redirect(portal.getData().getPortalUrl())

$portal = $commet->portal->getUrl(customerId: 'user_123');

redirect($portal->data['portalUrl']);

curl -X POST https://commet.co/api/portal/request-access \
  -H "x-api-key: $COMMET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customerId": "user_123"}'

Puedes identificar a los clientes con customerId (ID de Commet o tu ID externo) o email.

Helper de Next.js

@commet/next (solo Node.js) provee un route handler de una línea que genera URLs del portal y redirige automáticamente.

import { CustomerPortal } from '@commet/next'

export const GET = CustomerPortal({
  apiKey: process.env.COMMET_API_KEY!,
  getCustomerId: async (req) => {
    return 'user_123'
  },
})

<a href="/api/commet/portal">Gestionar cobros</a>

Relacionado

• Gestionar Suscripciones
• Plan Groups
• Credit Packs