Stripe Integration

Menu Path: Workspace > Settings > Integrations > Payment > Stripe

Stripe is a globally recognized payment gateway that allows your platform to accept credit cards, debit cards, and alternative payment methods like Apple Pay and Google Pay securely.

Prerequisites

Before integrating Stripe into your AVCI CMS workspace, you must:

1. Create a verified Stripe Account.
2. Complete your business identity verification (KYC) within the Stripe Dashboard.
3. Ensure your storefront is served over HTTPS (SSL).

Configuration Steps

To enable Stripe on your platform, follow these steps:

1. Retrieve API Keys

1. Log in to your Stripe Dashboard.
2. Navigate to Developers > API keys.
3. Locate your Publishable key and Secret key. (Use test keys if you are setting up a development/staging environment).

2. Enter Credentials in CMS

1. In the AVCI CMS admin panel, go to Integrations > Payment > Stripe.
2. Toggle the integration status to Active.
3. Enter your Publishable Key and Secret Key into the respective fields.
4. Click Save Settings.

3. Webhook Setup (Crucial)

Webhooks are required so that Stripe can inform the CMS when a payment succeeds asynchronously.

1. In the CMS Stripe integration page, copy the Webhook Endpoint URL.
2. Go back to your Stripe Dashboard > Developers > Webhooks.
3. Click Add an endpoint, paste the URL, and select the following events:
   • payment_intent.succeeded
   • payment_intent.payment_failed
   • charge.refunded
4. Copy the generated Webhook Signing Secret from Stripe and paste it into the Webhook Secret field in the CMS.
5. Save settings again.

Testing the Integration

We highly recommend testing the checkout flow using Stripe's mock credit card numbers (e.g., 4242 4242 4242 4242) before switching your integration to "Live Mode".

[!WARNING] Never enter your live Stripe Secret Key into a staging or development environment. Always use the test keys provided by Stripe to prevent accidental real-world charges.