mindora
All GuidesIntegrations

Stripe Integration Setup (Global)

Learn how to connect your Stripe account to receive online payments from your clients via credit card.

8 min
Intermediate

Why Mindora for Payments?

Before diving into the setup, here is why therapists and professionals choose Mindora for payment collection:

Zero Platform Commission

Unlike many booking platforms that take 0.5–1% (or more) from every single transaction, Mindora charges absolutely zero commission. Your client pays, and 100% goes to your account — minus only Stripe's standard processing fee.

Your Money, Your Account

Payments go directly into YOUR Stripe account. We never touch your money. Many competitors route payments through their own accounts first, creating delays and dependencies. With Mindora, there is no middleman.

Full Ownership

Your Stripe account, your client data, your payment history — it all belongs to you. If you ever leave Mindora, nothing changes on the payment side. No lock-in, no data loss.

What do competitors charge?
Most therapy/coaching platforms charge 0.5–1% per transaction on top of the payment provider fee. On a class="h-full"50 session, that is $0.75– class="h-full".50 extra per session — adding up to hundreds of dollars a year. With Mindora, that money stays in your pocket.

What is Stripe?

Stripe is a global online payment infrastructure that allows you to accept credit/debit card payments from your clients. Stripe operates in over 40 countries and supports 135+ currencies, making it one of the most widely used payment solutions worldwide.

When to Use Stripe?

Global Reach

Accept payments from clients anywhere in the world.

Card Payments

Accept Visa, Mastercard, American Express and other major cards.

Multi-Currency

Receive payments in USD, EUR, GBP and 135+ other currencies.

Note for Turkey
Stripe is not available in Turkey. If you practice in Turkey, use iyzico or PayTR to receive payments.

Prerequisites

Before setting up Stripe integration, you need:

1

Stripe Account

Create a free account at stripe.com if you don't have one.

2

Verified Account

Complete Stripe's identity verification to accept live payments.

3

Bank Account

Add your bank account to Stripe for payouts.

Step-by-Step Setup

Follow these steps to connect Stripe to Mindora:

Tip
Only one payment integration can be active at a time. If you already have another active integration (e.g., PayTR or iyzico), you'll see a confirmation dialog when starting Stripe setup. The existing integration will be deactivated when Stripe is connected.
1

Go to Settings

Click on the gear icon in the top right corner, or navigate to Settings from the sidebar menu.

2

Open Integrations

In the Settings menu, click on "Integrations" to see all available integrations.

3

Find Stripe Card

Look for the Stripe card in the "Payment & Finance" category. Click "Setup" button on the card.

4

Get API Keys from Stripe

Open Stripe Dashboard in a new tab. Go to Developers → API keys to find your keys.

5

Enter Secret Key

Copy the Secret Key (starts with sk_live_ or sk_test_) and paste it in Mindora.

6

Enter Publishable Key

Copy the Publishable Key (starts with pk_live_ or pk_test_) and paste it in Mindora.

7

Set Link Expiration

Choose how long payment links should be valid (default: 24 hours).

8

Test Connection

Click "Test Connection" to verify your API keys are working correctly.

9

Save

Click "Save" to complete the setup. Webhooks will be automatically configured.

Finding API Keys in Stripe

Here's how to find your API keys in Stripe Dashboard:

1

Open Stripe Dashboard

Go to dashboard.stripe.com and log in to your account.

2

Navigate to Developers

Click on "Developers" in the left sidebar menu.

3

Click API Keys

Select "API keys" from the submenu.

4

Copy Keys

You'll see both Publishable key and Secret key. Click "Reveal" to see the Secret key, then copy both.

Make sure you copy the correct keys:
For live paymentsUse keys starting with sk_live_ and pk_live_.
For testingUse keys starting with sk_test_ and pk_test_.

Test Mode vs Live Mode

Stripe provides two sets of API keys:

Live Mode

  • Uses sk_live_ and pk_live_ keys.
  • Processes real payments from real cards.
  • Money is actually transferred.
  • Use this when you're ready to accept payments.

Test Mode

  • Uses sk_test_ and pk_test_ keys.
  • No real money is transferred.
  • Use test card numbers provided by Stripe.
  • Good for testing the flow before going live.
Important
Test mode is useful for developers and testing the payment flow. For receiving actual payments from clients, always use Live mode keys.
Critical Warning for Testing

Always use test credentials with fake/test sessions only. Never test payment flows on real client sessions.

When a session is paid via a real or fake payment link, the system locks it permanently:

  • Payment status cannot be changed.
  • New payment link cannot be created.
  • Session fee cannot be modified.

Create a test client and test sessions specifically for testing payment flows.

Automatic Webhook Configuration

When you save your Stripe settings, Mindora automatically configures webhooks. This means:

Payment Completed

When client completes payment, status updates automatically.

Payment Failed

When payment fails, you're notified immediately.

Link Expired

When payment link expires, it's recorded in history.

Card Confirmed

When bank/card confirms the payment

Automatic Configuration
You don't need to configure webhooks manually. Mindora handles everything automatically when you save your integration.

After Setup

Once Stripe is connected:

The Stripe card on the Integrations page shows "Active" status with a green indicator.

You can create payment links from the Payments module. → Creating Payment Links

Clients can pay via Stripe Checkout (Stripe's hosted payment page).

Payment statuses update automatically. → Understanding Payment Statuses

All activities are recorded in payment history. → Payment History

Managing Your Integration

You can update or disconnect your integration at any time:

Update Settings

Change link expiration time without re-entering keys.

Change API Keys

Update to new keys if needed (e.g., switching from test to live).

Disconnect

Remove the integration completely. Active payment links will stop working.

What happens when you disconnect?
  • If you have active payment links, the system will automatically expire them on Stripe before removing your credentials.
  • A confirmation dialog will show you how many active links will be expired. You must confirm before proceeding.
  • Your API keys are stored encrypted with AES-256-GCM (256-bit) and are permanently deleted when you disconnect; Mindora does not retain them after disconnection.
  • Previously completed payments and refund records are preserved in payment history.
  • Refunds for past payments can no longer be processed through Mindora — you will need to refund manually from your Stripe dashboard.

Common Issues

Invalid API Key
Make sure the key starts with sk_ (Secret) or pk_ (Publishable). Check for extra spaces when copying.
Keys Don't Match
Both keys must be from the same mode. You cannot mix test and live keys.
Connection Test Fails
Verify your Stripe account is active and not restricted. Check if you have the correct permissions.
Payment Links Not Working
Ensure you're using Live mode keys for real payments. Test mode keys don't process actual charges.
Stripe Fees
Stripe charges standard transaction fees for each payment. The fees vary by country and card type. Check Stripe's pricing page for your region. Setting up a Stripe account takes approximately 30 minutes, and Mindora's guided integration makes connecting it simple and straightforward.