> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatcrafterai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Testing

# Testing Stripe Integration

Learn how to safely test your Stripe integration without processing real payments.

## Test Mode Setup

Before testing with real money, use Stripe's test environment:

1. In ChatCrafterAI integration settings, select **Test Mode**
2. Use test API keys from your Stripe dashboard (they start with `pk_test_` and `sk_test_`)
3. Enter test keys in ChatCrafterAI Stripe integration
4. Verify connection shows "Test Mode" status

## Test Card Numbers

Stripe provides test card numbers for different scenarios. Use these in your agent tests:

### Successful Payment

* **Card number:** 4242 4242 4242 4242
* **Result:** Payment succeeds

### Declined Payment

* **Card number:** 4000 0000 0000 0002
* **Result:** Card declined

### Requires Authentication

* **Card number:** 4000 0025 0000 3155
* **Result:** Requires 3D Secure authentication

### Expired Card

* **Card number:** 4000 0000 0000 0069
* **Result:** Card expired error

### Insufficient Funds

* **Card number:** 4000 0000 0000 9995
* **Result:** Insufficient funds error

**For all test cards:**

* Use any future expiration date (e.g., 12/25)
* Use any 3-digit CVC
* Use any postal code

## Testing Workflow

### Basic Payment Test

1. Set agent to **Test Mode** in integration settings
2. Open **Chatlab** (ChatCrafterAI testing environment)
3. Send message: "I want to pay my invoice"
4. Agent initiates payment flow
5. Use test card 4242 4242 4242 4242
6. Complete payment process
7. Check Stripe **Test Dashboard** for transaction
8. Verify agent receives success webhook
9. Confirm agent sends confirmation message

### Testing Different Scenarios

**Successful Transaction:**

1. Use card 4242 4242 4242 4242
2. Complete payment
3. Verify transaction appears in Stripe test dashboard
4. Confirm agent shows success message

**Failed Payment:**

1. Use declined card 4000 0000 0000 0002
2. Attempt payment
3. Verify agent displays appropriate error message
4. Check no charge appears in Stripe

**Customer Lookup:**

1. Create test customer in Stripe test dashboard
2. Ask agent: "What's my balance?"
3. Verify agent returns correct customer data

**Refund Processing:**

1. Complete successful test payment
2. Request refund through agent
3. Verify refund appears in Stripe test dashboard
4. Confirm agent shows refund confirmation

## What to Test

Essential test cases for your integration:

* **Payment flow** - Complete transaction from start to finish
* **Failed payments** - Handle declined cards gracefully
* **Customer lookup** - Find customers by email/ID
* **Balance check** - Display correct amounts
* **Invoice creation** - Generate and send invoices
* **Refunds** - Process full and partial refunds
* **Subscriptions** - Create, update, cancel
* **Error messages** - All errors display clearly
* **Webhook handling** - Agent receives and processes events

## Common Test Scenarios

### User Cancels Mid-Flow

1. Start payment process
2. User sends "cancel" or navigates away
3. Verify payment intent is cancelled
4. Confirm no charge occurs

### Invalid Customer ID

1. Agent attempts lookup with wrong ID
2. Verify graceful error handling
3. Check agent asks for correct information

### Network Disconnection

1. Simulate by temporarily disconnecting integration
2. Attempt payment
3. Verify agent shows connectivity error
4. Reconnect and retry successfully

### Duplicate Payment Prevention

1. Attempt same payment twice quickly
2. Verify idempotency key prevents duplicate
3. Confirm only one charge appears

## Switching to Production

When you're confident everything works:

1. **Verify all tests pass** in test mode
2. **Get production API keys** from Stripe dashboard (start with `pk_live_` and `sk_live_`)
3. **Update ChatCrafterAI integration** with production keys
4. **Change mode** to Production in settings
5. **Test with small amount** - Process one real transaction with minimal amount
6. **Monitor Stripe dashboard** for first few real transactions
7. **Full deployment** when confident everything works

## Test Checklist

Before going live:

* [ ] Successful payment completes end-to-end
* [ ] Failed payments show appropriate errors
* [ ] Customer lookup works correctly
* [ ] Balance displays accurate amounts
* [ ] Invoices generate and send properly
* [ ] Refunds process successfully
* [ ] Webhooks trigger agent actions
* [ ] All error messages are user-friendly
* [ ] Test mode transactions appear in Stripe test dashboard
* [ ] No test charges in production Stripe

## Next Steps

Encountering issues? Check the [Troubleshooting Guide](./troubleshooting).