7 min read
› Documentation › Stripe Setup

Stripe Setup

Setting up Stripe Integration

This guide explains how to configure Stripe payments in your application, with iaptic. With Stripe integration, you can process web-based payments and subscriptions while maintaining the interface and analytics provided for mobile in-app purchases.

We provide a browser SDK called Iaptic JS that simplifies the integration process with your web app. You can also use Stripe's own SDK directly and only use Iaptic for the webhook handling.

Prerequisites

Before starting the setup process, make sure you have:

  1. A Stripe account (Sign up here if needed)
  2. Access to your Stripe Dashboard
  3. Your application configured in Iaptic

Configuration Steps

1. Get Your API Keys

First, you'll need to get your API keys from Stripe:

  1. Log in to your Stripe Dashboard
  2. Navigate to Developers → API keys
  3. Set API version to 2024-11-20.acacia
  4. You'll see two types of keys:
    • Test keys (starting with sk_test_) for development
    • Live keys (starting with sk_live_) for production

Important: Keep your Secret Key secure and never expose it in client-side code.

2. Configure Webhook Endpoint

We maintain a dedicated guide for webhook configuration with detailed instructions and troubleshooting.

Continue with: Stripe Webhook Setup Guide

3. Configure Your Application

Now configure these values in your Iaptic dashboard:

  1. Go to Settings
  2. Find the Stripe section
  3. Fill in the following fields:
    • Stripe Secret Key: Your API secret key from step 1
    • Stripe Webhook Secret: The webhook signing secret from step 2

4. Testing the Integration

Before going live:

  1. Use test mode keys (sk_test_) to verify the integration
  2. Create a test product and price in your Stripe Dashboard
  3. Make a test purchase using Stripe's test cards
  4. Verify the purchase appears in your Iaptic dashboard

Production Checklist

Before switching to production:

  • [ ] Update iaptic webhook endpoint for production if needed
  • [ ] Configure live mode products and prices in Stripe
  • [ ] Replace test mode Secret Key with live mode key (sk_live_)
  • [ ] Test the complete payment flow with a real card
  • [ ] Verify webhook events are being received
  • [ ] Check that purchase data appears correctly in Iaptic

Common Issues

Webhook Events Not Received

  • Verify the webhook URL is correct
  • Check the webhook signing secret matches
  • Ensure all required events are selected
  • Look for failed webhook attempts in Stripe Dashboard

Invalid API Key

  • Confirm you're using the correct key for test/live mode
  • Verify the key has been copied correctly without extra spaces
  • Check the key format matches sk_test_ or sk_live_

Support

If you encounter any issues during setup:

  1. Visit the Stripe Documentation
  2. Contact Iaptic Support