​

Connecting Stripe to ChatCrafterAI

Follow these steps to connect your Stripe account to ChatCrafterAI.

​

Prerequisites

Before starting, ensure you have:

• A Stripe account (create one at stripe.com if needed)
• API keys ready (publishable and secret key)
• Webhook secret from Stripe

​

Step-by-Step Setup in ChatCrafterAI

1. Navigate to Agent Settings → Integrations
2. Click Add Integration → Select Stripe
3. Choose mode: Production or Test
4. Paste your Publishable Key
5. Paste your Secret Key
6. Paste your Webhook Secret
7. Click Connect
8. Verify the status shows Connected
9. Click Test Connection to verify the agent can communicate with Stripe

​

Finding Your Credentials in Stripe

​

API Keys

1. Log into your Stripe dashboard at stripe.com/dashboard
2. Go to Developers → API keys
3. Copy the Publishable key (starts with pk_)
4. Copy the Secret key (starts with sk_)

​

Webhook Secret

1. In Stripe dashboard, go to Developers → Webhooks
2. Find the ChatCrafterAI webhook endpoint (or create one if missing)
3. Click to view details
4. Copy the Signing secret (starts with whsec_)

​

Test vs Production Mode

Test Mode:

• Use this first to experiment without real transactions
• Test card numbers available (see Testing Guide)
• No actual charges processed

Production Mode:

• Use when ready for real customer transactions
• Real charges will be processed
• Requires production API keys

You can configure both modes and toggle between them as needed.

​

Webhook Setup

ChatCrafterAI automatically creates a webhook endpoint in your Stripe account when you connect. If you need to create it manually: Endpoint URL: https://api.chatcrafterai.com/stripe/webhook Events to enable:

• payment_intent.succeeded
• customer.subscription.updated
• invoice.payment_succeeded
• charge.refunded

​

Verification

After setup, verify the connection:

1. Open Chatlab (testing environment)
2. Send a test message: “What’s my balance?”
3. Agent should return a success message with balance amount
4. If you see an error, check that:
   • Keys are copied exactly (no extra spaces)
   • You’re using the correct mode (test vs production)
   • Webhook secret matches exactly

​

Troubleshooting Setup

Connection failed?

• Verify API keys are correct (no spaces before/after)
• Ensure you’re using keys from the correct mode
• Check your Stripe account is active

Webhook issues?

• Confirm webhook secret is copied correctly
• Verify webhook endpoint is reachable
• Check Stripe webhook dashboard for delivery status

​

Next Steps

Now that Stripe is connected, learn about Available Actions your agent can perform.