Skip to content
YionStack
HelpSetup

Connect Stripe to take card payments

Authorise the YionStack Stripe connection so card payments land in your Stripe account and reconcile to YionStack invoices automatically. UK SCA / 3D Secure enforced on the Stripe side; YionStack never sees the card.

In this guide

Setup
Steps
5
Prereqs
3
Pitfalls
3 common ones
Related
3 guides

Walkthrough only — no setup wizard. The flow is exactly what you do inside YionStack today.

Before you start

  • A Stripe account (Standard or Express; both work).
  • Owner or Admin role on the YionStack business.
  • A bank account on Stripe configured for payouts to your UK business account.

Steps

  1. 1

    Open the payments settings

    Go to Settings → Payments. The page lists every payment provider — Stripe, GoCardless, PayPal — with the connection status and the default provider for new invoices.

  2. 2

    Authorise Stripe

    Choose Connect Stripe. YionStack redirects to Stripe’s OAuth flow under your Stripe login. Approve the connection — only the scopes YionStack needs (read charges, write payment intents, attach customers) are requested.

  3. 3

    Confirm the default provider

    Back in YionStack, choose whether Stripe is the default provider for new invoices, or whether the customer picks at checkout (recommended when GoCardless is also connected for Bacs Direct Debit).

  4. 4

    Test with a real invoice

    Issue a £1 invoice to yourself or a test contact, click Pay Now from the customer-facing PDF, pay with a real card. The payment posts on the invoice, the receipt emails back, and Stripe shows the charge in the dashboard.

  5. 5

    Reconcile the payout

    Stripe payouts arrive in your bank account on the standard schedule (usually +2 working days for UK cards). The bank feed pulls the payout as one line; YionStack proposes the match against the Stripe fee + charge breakdown.

Common pitfalls

SCA challenges declined

UK and EU cards require Strong Customer Authentication. If the cardholder declines the 3D Secure challenge, the charge fails and Stripe surfaces the reason in the invoice activity feed; the invoice stays open for retry.

Stripe Tax double-counting

If both YionStack and Stripe Tax are configured to add VAT, the invoice could double-charge. Set the VAT on the YionStack invoice line and leave Stripe Tax off, or vice versa — never both.

Refund mismatch

Refunds initiated from the Stripe dashboard reconcile back into YionStack automatically. Refunds initiated from inside YionStack call the Stripe API and flow the other direction. Mixing both creates duplicate refund records — choose one direction.

Need a hand with this one?

If a step is missing or unclear, tell us — every guide is a working document we improve as customers ask.