How-to

Connect Stripe to accept customer card payments

Let customers pay sales invoices by card. Money settles to your Stripe account; invoices auto-mark paid.

2 min readLast updated 26 May 2026
Jump to section

What it does

Stripe Connect adds a Pay with card link to every sales invoice email. Your customer clicks, pays on Stripe's hosted page, and the money lands in your Stripe account directly — not via Blankitt. When Stripe fires the payment_intent.succeeded webhook we record the payment, post the GL journal, and flip the invoice to paid. The operator sees the same end state as a BACS receipt: a reconciled invoice, a GL hit, an audit trail.

Fees go straight to Stripe at their standard pricing. Blankitt adds no markup; we're a payment surface, not a payment processor.

How to use it

  1. Open Settings → Connected platforms and click Connect Stripe.
  2. You're redirected to Stripe's OAuth screen. Sign in to your existing Stripe account or create one. Authorise the connection.
  3. Redirected back, the settings page flips to Connected and shows your Stripe account ID.
  4. In your Stripe dashboard, copy the connected-account webhook secret (whsec_...) and paste it into Settings → Connected platforms → Stripe webhook secret. We use this to verify every incoming event.
  5. Send sales invoices as usual. The email and the PDF now include a Pay with card button pointing at Stripe's hosted checkout.
  6. When the customer pays, Stripe posts to /api/v1/finance/webhooks/stripe. Blankitt verifies the signature against your webhook secret, creates a fin_payments row, posts the journal, and marks the invoice paid.

Tips

  • The webhook secret is per-connected-account, not a global key. If you reconnect or rotate, fetch the new value from Stripe and update Settings — otherwise events will fail signature verification and invoices won't auto-mark paid.
  • Partial payments via Stripe are recorded as such — the invoice stays on partial until the balance lands. No manual reconciliation needed.
  • Disconnect via Settings → Connected platforms → Disconnect Stripe. Blankitt loses API access; Stripe continues to process any in-flight payments per their standard rules, you just stop seeing them auto-reconciled.
  • Refunds initiated in Stripe also fire webhooks — Blankitt posts a reversing journal and the invoice flips back to sent. Don't issue a separate Blankitt credit note for the same refund or you'll double-count.

Still stuck? Email support or open the support widget in the bottom-right.