Appearance
Privacy and your customers
Your portal collects personal data about the people who use your API: their names, email addresses, keys, usage and billing records. This page explains who is responsible for that data and the tools MicroAuth gives you to handle requests about it. It isn't legal advice, so check with your own advisor what applies to your business.
Who is responsible
- Your customers' data. You decide who can sign up on your portal and what you do with their data, so you are responsible for it. MicroAuth runs the portal and stores the data for you.
- Your users' data on a sign in service. The same applies to the people who sign in to your apps: you decide who gets in, and MicroAuth runs the sign in pages and stores their accounts for you. Find or delete a user from Users, and people can download their data or delete their account from their own account pages. The sign in users section of MicroAuth's privacy policy lists what is stored for them.
- Your own MicroAuth account. MicroAuth is responsible for the data about you and your teammates, such as your names, emails and sign ins. The privacy policy covers it.
Your privacy policy
Add a link to your own privacy policy under Branding, Links, Privacy policy. The portal shows it on the sign up page and in the footer.
Until you add one, the portal shows a short default notice instead. It names you as responsible for the data, using the business name on your connected Stripe account or "the team behind" your API's name, says MicroAuth runs the portal for you and links to the portal customers section of MicroAuth's privacy policy. The default notice is a fallback, not a replacement for your own policy.
Emails to your customers
MicroAuth emails your customers under your API's name, and only about their own account:
- Always sent. Sign in codes, invites, answers to sign ups that wait for approval, security notices, changes to their access, cards and team, changes your team makes to their account, and payment problems, such as a failed payment, a balance that ran out or an ended plan.
- Payments and plan changes. Credit added, automatic top ups, plan payments and plan changes, refunds and disputes you won.
- Balance alerts. A low balance.
- Team activity. For team admins: someone joined or left the team, or a teammate created or revoked an API key.
Billing emails go to the team's admins and billing members. Each person can turn off the topics they get under Notifications on the portal's Account page, or with the Unsubscribe link in the email. Their choices are part of the data they can download. See emails to your customers for when each one is sent.
Saved cards
Card numbers stay with Stripe. For the card that automatic top ups charge, MicroAuth keeps a copy of the brand, the last 4 digits and the expiry month and year from Stripe, along with its Stripe payment method ID and when the cards were last synced.
This copy is cleared when the card is removed in Stripe, the customer is deleted in Stripe, you disconnect Stripe, or you erase the customer. The card appears in your Export data file, and in the portal download for the team's admins and billing members.
When a card starts a free trial of your plans, MicroAuth keeps the fingerprint Stripe gives that card, with the Stripe subscription ID and the date, so the card can't start another one. A fingerprint isn't the card number, and the number can't be worked out from it. It isn't tied to the customer, so it stays when the customer is erased or deletes their account, and it's deleted when you delete the API. Without that, deleting an account and signing up again would give the same card another trial.
Requests from your customers
Most requests can be handled by your customers themselves on the portal's Account page, where they can:
- change their name, and change their email with a code sent to the new address
- see where they are signed in and sign out other devices
- choose which optional emails they get
- add passkeys and turn on two step verification
- download their data as JSON, including their email settings, passkeys and whether two step verification is on
- delete their account
When someone asks you instead, open the customer under Customers. These tools need the admin or owner role in your workspace, and each use is recorded in the activity log.
| Request | What to do |
|---|---|
| A copy of their data | Export data downloads one JSON file with the customer, its members and their sessions, passkeys and two step status, keys, invites, the saved card, the balance history, daily usage and related activity |
| Fix their details | Ask them to change it on the portal, or edit the customer name and notes yourself |
| Delete one person | Remove next to the person under Portal users. Their portal account goes, and the team keeps its keys and billing |
| Delete the whole customer | Erase customer, described below |
Passkeys and two step verification
When someone adds a passkey, MicroAuth stores its public key and credential ID, a name, which password manager or device made it when the browser says so, whether it syncs, and when it was added and last used. Fingerprints and faces never leave the person's device. Downloads and exports list each passkey's name, provider, sync status and dates, but never the key itself.
For two step verification MicroAuth keeps the authenticator secret, encrypted, and hashes of the unused recovery codes. Downloads say whether it is on, since when, and how many recovery codes are left. Removing a person or erasing a customer deletes all of it. See portal sign in for what your customers can do themselves and how to reset a customer who is locked out.
Erasing a customer
Erase customer is for deletion requests. It removes:
- the customer, its portal accounts, sessions, keys and invites
- its usage history and balance history
- pending emails to its members
It also replaces the customer's name and its members' names and emails in your activity log with labels such as "a deleted customer" or "Deleted user 4f2a9c", so the history of what happened stays without saying who. Any subscription is canceled.
With Also delete them in Stripe on, which is the default, the customer is also deleted in your connected Stripe account. Stripe keeps past invoices and payments, as it has to for tax and accounting. Turn it off if you need the Stripe customer, for example for an open dispute.
Delete customer is the quicker option for customers you no longer need. It doesn't scrub names from the activity log.
When a customer deletes their account
When the last member of a team deletes their account, the whole customer is erased as above and its customer in your Stripe account is deleted. A team with a paid plan has to cancel it under Billing first. When one member of a larger team leaves, only their portal account goes. Either way, your workspace's owners and admins get an email, unless they turn off Deleted portal accounts.
What we delete on our own
Some data is deleted on a schedule, whatever you do:
- Portal sign ups waiting for approval are deleted after 90 days if nobody approves them.
- The activity log is kept for 400 days, and the IP addresses in it are removed after 90 days.
- Invites are deleted 30 days after they are accepted or expire.
- Revoked keys are deleted 400 days after they are revoked, once their hourly usage is gone.
- Transfers are deleted 30 days after they are accepted, declined, canceled or expire.
The full list is under retention.
Your own account
The same rights apply to you and your teammates. Under Account in the dashboard you can change your email, see your sessions, manage your passkeys and two step verification, download your data and delete your account. The download includes your passkeys, without their keys, and whether two step verification is on. See your account.