Customer Portal

// In your billing settings page handler
const resp = await monigoClient.portal.createToken({
  customer_external_id: req.user.id,
  label: 'In-app billing link',
})

// Redirect the customer
res.redirect(resp.portal_url)

// In your billing settings route
resp, err := monigoClient.Portal.CreateToken(ctx, monigo.CreatePortalTokenRequest{
    CustomerExternalID: user.ID,
    Label:              "In-app billing link",
})
if err != nil {
    http.Error(w, "failed to generate portal link", 500)
    return
}
http.Redirect(w, r, resp.PortalURL, http.StatusFound)

import { MonigoProvider, MonigoPortal } from '@monigo/react'
import '@monigo/tokens/monigo.css'

<MonigoProvider portalToken={token} theme={{ primary: '#6366f1', mode: 'auto' }}>
  <MonigoPortal basePath="/billing" />
</MonigoProvider>

// When an invoice is finalized (invoice.finalized webhook)
async function onInvoiceFinalized(customerId: string, invoiceId: string) {
  const resp = await monigoClient.portal.createToken({
    customer_external_id: customerId,
    label: `Invoice ${invoiceId} email`,
    expires_at: new Date(Date.now() + 14 * 24 * 60 * 60 * 1000).toISOString(),
  })

  await mailer.send({
    to: customer.email,
    subject: 'Your invoice is ready',
    body: `View and pay your invoice: ${resp.portal_url}`,
  })
}

curl https://api.monigo.co/api/v1/portal/me \
  -H "X-Portal-Token: <token>"

curl "https://api.monigo.co/api/v1/portal/invoices?page=1&limit=20" \
  -H "X-Portal-Token: <token>"

curl -X POST https://api.monigo.co/api/v1/portal/invoices/<invoice_id>/pay \
  -H "X-Portal-Token: <token>"

// Good — uses your own stable ID
const resp = await client.portal.createToken({
  customer_external_id: user.id,   // your DB's user ID
})

// Acceptable but requires tracking Monigo UUIDs
const resp = await client.portal.createToken({
  customer_id: monigoCustomerId,
})

// Next.js API route: /api/billing-portal
import type { NextApiRequest, NextApiResponse } from 'next'
import { monigoClient } from '@/lib/monigo'

export default async function handler(req: NextApiRequest, res: NextApiResponse) {
  if (req.method !== 'GET') return res.status(405).end()

  // Identify the authenticated user from your session
  const session = await getSession(req)
  if (!session) return res.status(401).json({ error: 'Unauthorized' })

  const resp = await monigoClient.portal.createToken({
    customer_external_id: session.userId,
    label: `In-app — ${session.userId}`,
  })

  // Redirect straight to the portal, or return the URL to the frontend
  res.redirect(302, resp.portal_url)
}

// Go HTTP handler
func BillingPortalHandler(w http.ResponseWriter, r *http.Request) {
    userID := sessionUserID(r) // from your session/auth middleware

    resp, err := monigoClient.Portal.CreateToken(r.Context(), monigo.CreatePortalTokenRequest{
        CustomerExternalID: userID,
        Label:              fmt.Sprintf("In-app — %s", userID),
    })
    if err != nil {
        http.Error(w, "failed to generate portal link", http.StatusInternalServerError)
        return
    }

    http.Redirect(w, r, resp.PortalURL, http.StatusFound)
}