Customer Portal for Vendors
Give your customers a self-service license dashboard: passwordless login with your team slug, Standard-plan availability, and a team-level off switch.
Overview
The Customer Portal is a hosted, self-service dashboard where your customers view licenses, monitor activated devices, release seats when moving machines, and update their contact information — without emailing you. Login is passwordless: customers enter your vendor code plus their registered email, then a 6-digit code emailed to them.
Send your customers to app.keymint.dev with the Customer tab selected, and share the customer login walkthrough: Customer Portal.
Vendor Code
Your vendor code is your team slug — the same slug in your dashboard URLs. It cannot be changed after team creation, and it doubles as a public login identifier, so treat it as shareable (not secret). Find it in Team Settings under Vendor Code, with a copy button.
Availability
The portal requires both:
- An active Standard plan or above on your workspace.
- The Customer portal toggle switched on in Team Settings (requires
settings:write; on by default).
If either is missing, your customers see "Customer portal isn't available for this vendor code." — one message for every cause, so plan and toggle state can't be probed. If a customer reports that error and you believe it's wrong, check your plan status and toggle before contacting support.
Deactivating an individual customer blocks their login independently of these settings.
Login Security
- Codes are 6 digits, expire after 10 minutes, and are single-use.
- Verification is rate-limited with brute-force protection; repeated failures temporarily lock further attempts.
- Unknown emails get the same success response as real ones, so your customer list can't be enumerated.
- Warn your customers never to share verification codes.
Troubleshooting (for your support macros)
| Customer report | Cause / fix |
|---|---|
| "Customer portal isn't available for this vendor code" | Plan below Standard, or toggle off — check both in Team Settings |
| No verification email | Spam/junk, misspelled email, or email not registered to any active customer under your workspace |
| Code doesn't work | Expired (10 min) — ask them to request a new one |
| Can't log in at all | Vendor code typo (it's the team slug, case-insensitive) or customer record deactivated |