Prerequisites
Before you begin, make sure you have:- An active Stripe account
- Access to your Aikeedo admin panel
- Basic understanding of payment gateways (don’t worry, we’ll guide you through the process!)
Step 1: Set Up Your Stripe Account
If you haven’t already, sign up for a Stripe account:- Visit the Stripe website and click “Start now” or “Create account”
- Follow the prompts to create and verify your account
- Complete any additional verification steps required by Stripe
Step 2: Obtain Stripe API Keys
To connect Aikeedo with Stripe, you’ll need to retrieve your API keys:- Log in to your Stripe Dashboard
- Navigate to Developers > API keys
- You’ll see two types of keys:
- Publishable key: Starts with
pk_
- Secret key: Starts with
sk_
- Publishable key: Starts with
Keep your secret key confidential! Never share it publicly or include it in client-side code.
Step 3: Set Up Stripe Webhooks
Webhooks are crucial for handling recurring payments and keeping your Aikeedo platform in sync with Stripe. Here’s how to set them up:- In your Stripe Dashboard, go to Developers > Webhooks
- Click “Add endpoint”
- Enter your webhook URL:
https://your-aikeedo-domain.com/webhooks/stripe
- Under “Events to send,” select the following:
invoice.created
invoice.updated
invoice.finalized
invoice.marked_uncollectible
invoice.payment_succeeded
invoice.deleted
invoice.voided
customer.subscription.updated
customer.subscription.deleted
- Click “Add endpoint” to create the webhook
- After creation, you’ll see a “Signing secret” - copy this for later use
If you’re not sure which events to select, it’s safe to choose “Select all events” for comprehensive coverage.
Step 4: Enable Stripe in Aikeedo
Now that you have your Stripe account set up, it’s time to configure Aikeedo:- Log in to your Aikeedo admin panel
- Navigate to Settings > Payments > Stripe
- Toggle the switch to enable Stripe payments
- Choose the appropriate mode:
- Test: For testing payments (use Stripe’s test cards)
- Live: For processing real transactions
- Enter the following details:
- API Publishable Key: Your Stripe publishable key
- API Secret Key: Your Stripe secret key
- Webhook Secret: The signing secret from your webhook setup
- Click “Save changes” to apply your settings
Congratulations! Stripe payments are now enabled on your Aikeedo platform.
Testing Your Integration
Before going live, it’s crucial to test your Stripe integration:- Set Aikeedo to “Test” mode
- Use Stripe’s test card numbers to simulate various payment scenarios
- Create a test subscription or product purchase
- Verify that payments are processed correctly and webhooks are functioning
Troubleshooting
If you encounter any issues with your Stripe integration, try these steps:- Double-check all API keys and secrets for accuracy
- Ensure your webhook URL is correct and accessible
- Review Stripe’s dashboard for any error logs or failed webhook attempts
- Check Aikeedo’s error logs for any integration-related issues