GoSmoko and Stripe

Get paid from the invoice email

Paste a Stripe secret key and every invoice you send gets a Pay now button backed by a Stripe hosted checkout page. When the customer pays by card, Stripe tells GoSmoko and the invoice is marked paid with a payment record attached — no manual reconciling, no double entry.

Connects via
API key
API
Stripe REST API 2024-06-20 (Payment Links, Checkout, Webhooks)
Regions
New Zealand, Australia, Global
A worker in a white t-shirt looking at a smartphone
Photo: Jeswin Thomas / Unsplash

Supported today

What the Stripe integration does

Every capability below is built and running. Nothing on this list is a plan.

GoSmoko → provider

Hosted payment links

A Stripe payment link is created per invoice and embedded in the invoice email and the customer's invoice page.

Provider → GoSmoko

Automatic reconciliation

A signed Stripe webhook marks the invoice paid, writes a payment record, and stores the Stripe reference.

GoSmoko → provider

Card, Apple Pay, and Google Pay

Whatever payment methods you have enabled in your Stripe dashboard are offered on the checkout page.

On the roadmap — not available yet

  • Partial payments and deposits

    Take a deposit against a quote before the job starts and net it off the final invoice.

  • Payouts reporting

    Show Stripe fees and payout timing in GoSmoko's reports so your revenue figures are net.

Setup

Connecting Stripe, step by step

  1. 1

    Open your Stripe API keys

    In the Stripe dashboard go to Developers, then API keys. Use a test key first if you want to trial the flow safely.

    Stripe API keys
  2. 2

    Copy the secret key

    Reveal and copy the secret key (it starts with sk_live_ or sk_test_). Do not use the publishable key — it cannot create payment links.

  3. 3

    Paste it below and save

    GoSmoko validates the key against your Stripe account before storing it, then encrypts it. You will see your Stripe account name once it connects.

  4. 4

    Add the webhook endpoint

    In Stripe go to Developers, then Webhooks, and add the endpoint URL shown on this page listening for checkout.session.completed. Copy the signing secret back into the field below so GoSmoko can verify Stripe really sent the event.

    Stripe webhooks
  5. 5

    Send a test invoice to yourself

    Use a test key and Stripe's 4242 4242 4242 4242 card to watch the invoice flip to paid end to end.

You will need

  • An activated Stripe account that can accept charges in your currency.
  • A secret key with write access (the standard secret key has this).
  • A publicly reachable GoSmoko URL so Stripe can deliver webhooks.

Limits worth knowing

  • Refunds are issued from the Stripe dashboard, not from GoSmoko.
  • Stripe fees are not deducted from the revenue figures in GoSmoko reports.
  • One Stripe account per GoSmoko business.
Stripe API documentation

Data flow

Exactly what moves, and which way

No surprises in your ledger. This is the complete list of what crosses the boundary between GoSmoko and your provider.

RecordDirectionFields
Payment linkGoSmoko → providerInvoice number, amount including GST, currency, and description.
PaymentProvider → GoSmokoAmount paid, timestamp, and Stripe checkout session id.
Invoice statusProvider → GoSmokoMoved to paid or partial based on the amount received.

Ready to connect Stripe?

Start the free trial and set it up from Settings → Integrations. It takes minutes, and you can disconnect at any time.