DocsStripe App

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:

PermissionWhy
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.

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:

WhenWhat you see
LinkedThe 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 linkedWhy nothing tied it to a visit, and the fix from Coverage and fixes when there is one. Nothing is guessed.
Not receivedTally 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 siteThe 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 endedThe 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.