Step 1: Create a Stripe Account
If you do not already have a Stripe account, visit stripe.com and sign up. Complete the business verification process, which typically takes 1-2 business days.
Step 2: Connect Stripe to SteepleOS
- In SteepleOS, go to Admin > Platform > Stripe.
- Click Connect with Stripe. You will be redirected to Stripe's OAuth flow.
- Authorize SteepleOS to access your Stripe account.
- Once connected, your Stripe Account ID will appear on the settings page.
Step 3: Configure Webhooks
Webhooks allow Stripe to notify SteepleOS about payment events in real time.
- In your Stripe Dashboard, go to Developers > Webhooks.
- Add an endpoint:
https://yourdomain.com/api/webhooks/stripe. - Select these events:
checkout.session.completed,invoice.payment_succeeded,invoice.payment_failed. - Copy the webhook signing secret and paste it into Admin > Platform > Stripe > Webhook Secret.
Step 4: Test the Integration
- Enable Stripe Test Mode in SteepleOS settings.
- Use Stripe's test card number
4242 4242 4242 4242to simulate a donation. - Verify the transaction appears in both Stripe and SteepleOS under Giving > Transactions.
- Once confirmed, switch to Live Mode.