Customer accounts and purchase restoration
Give a paying customer a safe way to sign in after they reinstall your extension or move to another Chrome profile. Customers create or sign into their TopPay account before they see an offer and continue to Stripe Checkout. Their email receipt is never treated as proof of access.
One account, the customer’s active access.
When a customer creates or signs into a TopPay customer account before checkout, TopPay attaches the purchase to that account. On a new computer, they sign in again and your extension asks TopPay for the current entitlement.
Sign in or create an account
Ask for an email and a 12–128 character password. The ready-to-test Chrome download already includes a basic account panel.
Pay through Stripe
TopPay reuses the signed-in customer record and the seller’s configured Stripe checkout. Your customer still sees the seller’s offer.
Sign in and check access
Your extension calls getUser(). Unlock only when TopPay returns an active entitlement for the plan you protect.
Use the same SDK you use for checkout.
Customer accounts are required before a Chrome extension can start a free trial or Stripe Checkout. TopPay saves the account email when the customer creates their account, including when they later leave checkout without paying.
const topPay = TopPay("your-app-id");
// Show the right account controls in your popup.
const account = await topPay.getCustomerAccount();
// Before a first checkout, let the customer create or sign into their TopPay account.
await topPay.createCustomerAccount({ email, password });
// or: await topPay.signInCustomer({ email, password });
// This remains the source of truth for paid access.
const user = await topPay.getUser({ profileId: "main" });
if (user.active) unlockPremiumFeatures();
// Let the customer sign out from this Chrome profile when they choose.
await topPay.signOutCustomer();What a customer should experience.
- 1
Create an account or sign in first
Make this the first step in your extension. Do not display a checkout button until the customer has created a TopPay customer account or signed into one they already own.
The current Chrome profile has a TopPay customer session.
- 2
Show the app’s available choices
After sign-in, show only the offers the developer configured for this app: for example, Start free trial, monthly, yearly, or one-time access. Let the customer choose their option before they leave the extension.
The customer knows exactly what they will start or pay for.
- 3
Start Stripe Checkout
Call
openPaymentPage()for the customer’s selected plan. Stripe opens in a new browser tab because hosted Checkout cannot be embedded inside an extension popup.Stripe processes payment for the connected seller account.
- 4
Return and refresh access
When checkout finishes, return the customer to your extension and call
getUser()again. Do not unlock from the success URL alone.TopPay’s server-confirmed entitlement decides access.
- 5
Install on another device
On the new Chrome profile, the customer signs in with the same customer account. Your extension calls
getUser()and sees the same active access while their subscription or purchase remains eligible.The customer resumes paid use without purchasing again.
What TopPay deliberately will not do.
Purchase restoration must prove that the person using the new browser owns the customer account. An email address by itself is not proof.
- Passwords are never available to an app owner. TopPay retains a one-way salted password hash solely to authenticate the customer. Checkout analytics carries the account email and checkout state, never a password.
- Older anonymous purchases stay anonymous. A purchase made before the customer created or signed into a TopPay account cannot be claimed by entering its receipt email on a new device.
- Sessions are device-specific. A signed-in customer can stay signed in on one Chrome profile for up to 30 days. Signing out removes that profile’s session; it does not cancel their subscription.
- Keep access checks server-backed. Billing changes, refunds, chargebacks, failed renewals, and manually granted access can all change what
getUser()returns. - Plan a support path. TopPay customer accounts currently do not include email verification or self-service password reset. Do not promise those flows until you configure and test an email provider or another verified recovery method.
Review facts before you respond.
In Customers & access, open a customer and choose Download report. The owner-only export puts the TopPay records for that account into one chronological, reviewable file.
Show the actual journey
The report can include account creation, successful sign-ins, Checkout starts, checkout completion, cancellation, closed-window, and expiration signals that TopPay recorded.
Separate facts from guesses
With the current SDK, signed-in app opens and feature_* events can appear alongside owner access actions and a count-only device summary.
Match the payment
Verified payment, refund, and dispute events include the recorded plan, amount, time, and Stripe reference when available.
For future customer-account, Checkout, and signed-in usage events, TopPay records the IP observed at its edge and limited browser information for account-security and dispute evidence, then removes those network records after up to 400 days. The packet shows these fields only to the app owner for the selected customer. It never includes passwords, card data, browsing history, raw device identifiers, or Chrome account information.
Run the real recovery test.
Use an active test or live plan only when you understand whether it can charge a real card.
- 1
Create a customer account
Install your extension in one Chrome profile. Create an account, complete checkout, then confirm
getUser()returns active access. - 2
Use a different profile
Open another Chrome profile or a second computer. Install the extension, sign into the same customer account, and run the same access check.
- 3
Verify a billing change
Cancel, refund, or otherwise change the test purchase according to your plan. Refresh access and confirm protected features lock when TopPay reports that they should.
See how trials, cancellations, refunds, disputes, and promo codes affect a customer’s entitlement.
