🚶First steps
Before connecting Stripe, make sure your Transactions module is activated in your Qomon space.
If you haven’t activated the module yet, contact your Qomon account manager or the support team.
✅ Step 1: Enable the Stripe Module
Go to Space Settings > Integrations & API.
Click Activate on the Stripe integration card.
You'll be redirected to securely enter your Stripe account information.
⚙️ Step 2: Set up your syncing method
Once your Stripe account is connected, Qomon will begin syncing new incoming transactions. Each transaction will be linked to a Qomon product or donation amount using one of two methods.
🟩 Method 1: Sync via Stripe Products (price.ID)
This is the recommended approach.
How it works:
You create products and prices in Stripe.
Qomon checks the transaction’s
price.ID.We match that ID to a donation/membership you’ve defined in Qomon.
What you need to do:
Follow Step 1 (enabling the Stripe Module).
Share with us your list of Stripe
price.IDs.We’ll configure the mapping between Stripe and Qomon.
⚠️ Note: If a price.ID isn't recognized, the transaction is logged as an open donation.
Best suited for:
Fixed donation/membership tiers
Stripe-hosted forms (like Checkout or Payment Links)
Simpler, more automated workflows
🟨 Method 2: Sync via Metadata (price_id in metadata)
This method is ideal when using custom forms or when you want to manage prices outside the Stripe product catalog.
How it works:
You attach a field like
price_id: "adh_simple"to the metadata of each Stripe transaction.Qomon reads this value and maps it to a predefined donation or membership on your space.
What you need to do:
Ensure your forms correctly insert the
price_idinto transaction metadata (example shown below).Share your full list of expected
price_idvalues with Qomon for setup.
⚠️ Note: You can only define one price_id per transaction. Sync errors may occur if price_id is missing or incorrect
Best suited for:
Custom-built forms on websites
Complex membership logic
Organizations with non-Stripe-native pricing
🎯 How Qomon handles transactions above the product price
A transaction can only contain one product at a time, but the total amount can exceed the price of that product.
In such cases, the excess amount is automatically considered an open donation.
Example: If a transaction totals $100 for a membership product priced at $20, the remaining $80 will be recorded as an open donation in addition to the membership.
💻 How it will look in Qomon
Stripe donations will appear as individual transactions in your Transactions list (not in a batch).
The Qomon user listed on the transaction will be marked as an external source.
When you click into a transaction, you’ll see:
The first and last name of the donor
The date the donation was paid
The type of card used (Visa, Mastercard, etc.)
The last 4 digits of the card
Everything is automatically recorded and synced—keeping your data accurate and up to date.
💡 Important note:
Payments are not processed through Qomon. Donors will still make contributions using your usual Stripe payment methods—via your website, donation pages, or embedded forms.
Once a payment is completed, the transaction will automatically appear in Qomon for tracking, reporting, and contact history.