Skip to content
Integrations

Stripe connector

2 min read

Connect Stripe to place one aggregate revenue summary for each closed month in a client mind.

What it imports

  • Gross successful-charge revenue
  • Payment count
  • Refund totals and revenue net of refunds
  • Paid-invoice count and amount
  • Month-over-month revenue change

Armbrain never stores individual charges, invoices, customers, email addresses, card details, or other payment-level data. Stripe rows are reduced to totals while they are read, then discarded.

Create a restricted key

Use a restricted key so Armbrain can read only the two Stripe resources it needs.

  1. Sign in to the Stripe Dashboard for the client account.
  2. Open Developers → API keys.
  3. Choose Create restricted key.
  4. Give the key Read access to Charges and Invoices.
  5. Leave every other resource set to None.
  6. Create the key and copy it. Restricted keys begin with rk_.

Do not paste a secret key beginning with sk_. If this key is ever exposed, roll it in Stripe and reconnect the connector with a new restricted key.

Connect

  1. Open Settings → Connectors in Armbrain HQ.
  2. Choose Stripe.
  3. Select the client mind that should receive the revenue summaries.
  4. Paste the restricted key and select Continue.

Armbrain verifies the account plus read access to Charges and Invoices before encrypting and saving the key.

Sync behavior

  • The connector checks daily.
  • It summarizes only the most recently completed calendar month, never the month still in progress.
  • A period is identified by the Stripe account and month, such as stripe:acct_123:2026-06.
  • Rerunning a month updates that memory in place. This captures late refunds without duplicates.
  • Charges and invoices are paginated until Stripe reports there are no more pages.

Troubleshooting

  • Key rejected: Confirm the key begins with rk_, is active, and belongs to the intended Stripe account.
  • Missing read access: Edit or replace the restricted key so Charges and Invoices both have Read access.
  • Revenue looks different: Confirm you are comparing the same completed calendar month, currency, and refund treatment in Stripe. Armbrain reports successful charges minus refunded amounts and lists paid-invoice totals separately to avoid double counting.
  • Current month is missing: This is intentional. Armbrain summarizes only closed months.