Stripe Integration for Paid Submissions

This guide will walk you through integrating Stripe with your directory to accept paid submissions. The setup process has been streamlined - you only need a Stripe Restricted Key, and everything else (webhook creation, product syncing) happens automatically.

​

1. Enable Paid Submissions

1. Navigate to the Settings section of your directory.
2. Go to Paid Submissions.
3. Enable Paid Submissions and select Stripe as the payment provider.

​

2. Create a Stripe Restricted Key

To integrate Stripe securely, you need to create a Restricted Key with specific permissions.

​

Quick Setup (Recommended)

Click the button below to create a pre-configured Restricted Key with all required permissions: Create Restricted Key in Stripe → This link will:

• Pre-fill the key name as “Directify Paid Submissions”
• Automatically select all required permissions
• Take you directly to the Stripe key creation page

​

Manual Setup (Alternative)

If you prefer to create the key manually:

1. Log in to your Stripe Dashboard.
2. Navigate to Developers > API Keys.
3. Click Create restricted key.
4. Name your key (e.g., “Directify Paid Submissions”).
5. Configure the following permissions: Required Permissions:
   • Products: Read
   • Prices: Read
   • Plans: Read
   • Checkout Sessions: Write
   • Customers: Write
   • Webhooks: Write
6. Click Create key and copy the generated restricted key.

​

3. Connect Your Stripe Account

1. In your directory’s Paid Submissions settings, paste the Restricted Key into the designated field.
2. The Webhook URL is automatically displayed - you don’t need to manually configure it.
3. Click Verify Credentials and Pull Plans.

​

What Happens Automatically

When you verify your credentials, the system will:

• ✅ Validate your Stripe restricted key
• ✅ Automatically create a webhook endpoint in your Stripe account
• ✅ Configure the webhook with the required events:
  • customer.subscription.created
  • customer.subscription.updated
  • customer.subscription.deleted
  • customer.created
  • checkout.session.completed
• ✅ Store the webhook secret securely
• ✅ Pull all active products and prices from your Stripe account

​

4. Create Payment Plans in Stripe

Before syncing, make sure you have products set up in Stripe:

1. Navigate to Products in your Stripe dashboard.
2. Create products for your submission plans:
   • Subscription Plans: Monthly, Yearly, etc.
   • One-Time Payment Plans: Single submission fee
3. Ensure products are marked as Active.
4. Add pricing for each product.

​

5. Customize Your Plans

After pulling plans from Stripe, you can customize how they appear to users:

1. Review the imported plans in your directory settings.
2. For each plan, you can:
   • Edit the description
   • Customize button text
   • Add features to display
   • Mark plans as bestseller
   • Add text below button
   • Hide plans you don’t want to offer
3. Click Save to finalize your configuration.

​

6. User Experience for Paid Submissions

Once configured, users can submit paid listings to your directory:

1. A user submits their content to the directory.
2. They are directed to the submission dashboard.
3. They click Pay and Submit for Review.
4. Available plans (subscription or one-time payments) are displayed.
5. The user selects a plan and completes payment via Stripe’s secure checkout.
6. Upon successful payment, their submission is processed for review.

​

Test Mode vs Live Mode

​

Troubleshooting

​

Webhook Issues

If webhooks aren’t working:

1. Check that the webhook endpoint was created successfully in your Stripe Dashboard under Developers > Webhooks.
2. Verify the webhook URL matches the one shown in your directory settings.
3. Ensure all required events are enabled on the webhook endpoint.

​

No Plans Showing Up

If plans aren’t syncing:

1. Verify your products are marked as Active in Stripe.
2. Check that each product has at least one active price.
3. Ensure your restricted key has Products and Prices read permissions.
4. Click Verify Credentials and Pull Plans again to re-sync.

​

Permission Errors

If you see permission errors:

1. Verify your restricted key has all required permissions listed in Step 2.
2. Create a new restricted key if needed and update your settings.

​

Conclusion

Your directory is now integrated with Stripe using a streamlined setup process! With just a restricted key, you can:

• ✅ Automatically sync products and prices
• ✅ Auto-configure webhooks
• ✅ Accept subscriptions and one-time payments
• ✅ Securely process payments

If you experience any issues, check the Stripe dashboard for logs and debugging information, or refer to the troubleshooting section above.

---