Troubleshoot Stripe connection and sync in Piraja CRM. Check connection status, permissions, and data flow.
Problem statement
The issue
Stripe is not connected, or data (invoices, payments, customers) is not syncing as expected between Stripe and Piraja. This can mean:
- The Stripe integration is not connected or has been disconnected
- Connection succeeds but data does not appear in the Finance module
- Invoices or payments created in Stripe do not show in Piraja (or the other way around)
- You see errors when trying to create or send an invoice
Common scenarios
Scenario 1: Stripe not connected
- You open Finance or Stripe settings and see a prompt to connect
- No Stripe data appears in the CRM
Scenario 2: Connected but no sync
- Stripe shows as connected, but recent invoices or payments are missing in Piraja
- Sync may be delayed or failing
Scenario 3: Permission or scope issues
- Connection was made with limited permissions
- Some Stripe features (e.g. certain payment types) may not be available
Step-by-step checks
1. Verify Stripe is connected
- Go to the Stripe integration or Finance module settings (as in your app).
- Confirm that Stripe is connected for your business. If you see "Connect Stripe", complete the OAuth flow and grant the requested permissions.
- After connecting, ensure you're not in a disconnected or expired state. If Stripe was connected before and now shows disconnected, try reconnecting.
2. Check sync and errors
- After connecting, allow a short time for initial sync (a few minutes). Large accounts may take longer.
- If you created an invoice or payment in Stripe, refresh the Finance view or check the relevant list in Piraja.
- Look for any error message or warning in the Stripe/Finance settings or sync status. Note the exact text if you contact support.
3. Permissions and webhooks
- Stripe connection uses OAuth and (where applicable) webhooks. Ensure your Stripe account is in good standing and that webhooks (if used) are not disabled or misconfigured.
- If you use webhooks, confirm the endpoint and events match what Piraja expects. Incorrect webhook configuration can cause missing or delayed data.
Still not working?
If you've checked the connection, permissions, and sync and the issue persists, collect the following and contact support at support@piraja.io:
- That you're troubleshooting Stripe connection or sync
- Whether Stripe shows as connected in your app
- Any error messages you see (exact text or a screenshot)
- What you expected to see (e.g. invoices, payments) and where (Stripe vs Piraja)
- When you last saw data sync correctly (if ever)
This information helps the team diagnose connection, scope, or sync issues quickly.
Frequently asked questions
Do I need a Stripe account?
Yes. The Stripe integration connects your existing Stripe account to Piraja. Create an account at stripe.com if you don't have one, then connect it from Finance or Stripe settings.
Will reconnecting Stripe lose data?
Reconnecting usually re-establishes the link; existing data in Piraja that was already synced typically remains. New sync will pull from Stripe again. If you're unsure, contact support at support@piraja.io before disconnecting.
Why do invoices created in Piraja not show in Stripe (or the other way around)?
Sync direction and timing depend on how the integration is configured. Some actions create records in Stripe first and then sync to Piraja; others may originate in Piraja. Check the Stripe Integration and How to Invoice Customers with Stripe. If you've verified connection and permissions and data still doesn't match, contact support at support@piraja.io.
Who can I contact for help?
Contact support at support@piraja.io.