03 · Revenue
Connect Stripe with the Tally app
Install the app in Stripe, link the account to your site in Tally, and each payment's page in Stripe shows the visit it came from.
01Install the app
Install Tally by Outpost from the Stripe App Marketplace, in live mode, the test mode sandbox or a sandbox. Stripe asks you to approve what it may read, all of it read-only:
| Permission | Why |
|---|---|
| PaymentIntents (read) | Each payment's amount, currency, customer and metadata, including the visitor id your checkout passes. |
| Checkout Sessions (read) | The visitor id in metadata or client_reference_id, and which Payment Link made the sale. |
| Invoices (read) | A subscription's first payment from a renewal or a plan change, and the tax in it. |
| Customers (read) | Metadata and email, to match a sale to a visitor who signed in on your site. The email is hashed at once and never stored. |
| Charges (read) | Refunds, so revenue is net of them, and the payment a charge belongs to. |
| Disputes (read) | Chargebacks, and funds reinstated after a won dispute. |
| Events (read) | Your payment, refund and dispute events within seconds. |
It adds nothing to your Stripe account: no webhook, and no key for you to make or copy.
02Link it to your Tally site
Open the app's settings
Stripe opens the app's settings page after the install (later: Settings › Apps › Tally by Outpost). Press Connect to Tally: Tally opens in a new tab.
Sign in, or create an account
A new account starts Tally's 14-day trial, with no card.
Choose the site
Choose the site whose payments this Stripe account brings in. Tally imports the past 365 days of payments, refunds and chargebacks, and follows new ones as they happen.
Go back to Stripe
The app's settings page shows the site, the mode and how far the import has come. Its figures, the linked revenue of the last 30 days and the trial's days left, are shown to the Stripe account's administrators only.
- Only an administrator of the Stripe account can link it. Anyone else is asked to have one do it.
- Installing the app links nothing by itself, wherever you started the install: an administrator links the account from the app's settings page, as above, or from a payment's page while the account isn't linked.
- A link works for 30 minutes, once. Open the settings page again for a new one.
- Live mode and each sandbox are linked on their own. A Stripe account feeds one Tally site in each mode.
- Payments made in test mode or a sandbox are test payments: listed on Sales with their receipts, marked as tests, and counted in no total.
03If you connected Stripe with a restricted key
Linking the same Stripe account through the app moves its connection to the app: the same connection, with its payments and receipts. Once the app's first import works, Tally deletes its webhook from your account and stops using the key, which you can then delete in Stripe (Developers › API keys); if the app can't read the account, the connection stays on the key. Nothing changes until you link it.
04Each payment's receipt in Stripe
Open a payment in Stripe and the app shows where it came from, from what Tally holds about it:
| When | What you see |
|---|---|
| Linked | The source, campaign, landing page and first visit, how the payment was tied to the visit (checkout metadata, a Payment Link's tag, the success page or an email match) and how sure that is. A renewal or refund shows the payment it follows. |
| Not linked | Why nothing tied it to a visit, and the fix from Coverage and fixes when there is one. Nothing is guessed. |
| Not received | Tally has no such payment: it failed or wasn't captured, it's older than the import, or it was made seconds ago. |
| Not linked to a site | The Stripe account isn't linked to a Tally site through the app yet, in this mode. Connected only by a restricted key? Its payments' receipts show once an administrator links it through the app. |
| Plan ended | The site's account has no plan: its trial or plan ended, or it isn't paid. Choose one under Billing in Tally. |
The app sends Tally the payment's id, your Stripe account's id, your Stripe user id, the mode, the account's name and your roles in it, signed by Stripe. Tally answers with what it already holds (and, while the account isn't linked, gives an administrator a link), and doesn't store your roles or which payments you viewed.
05Unlink or uninstall
- Disconnect it on the site's Integrations page: Tally stops reading the account's payments. The app stays installed in Stripe until you uninstall it.
- Uninstall the app in Stripe (Settings › Apps): Tally disconnects the account the same way, and its card says so.
- Either way the payments already imported, and their receipts, stay. Install and link it again to bring new ones in: the same connection, its history kept.
Something missing, or not what you see? Write to support@tallybyoutpost.com and say which page.