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

# Stripe Installation

> How to install and configure Stripe integration

# Installing Stripe Integration

Learn how to install and configure the Stripe integration in your workflow environment.

## Prerequisites

Before you begin, ensure you have:

* A Stripe account (test or production)
* API keys from your Stripe Dashboard
* Webhook endpoint configuration capability
* SSL enabled for your endpoints

## Installation Steps

### 1. Get API Keys

1. Log in to your [Stripe Dashboard](https://dashboard.stripe.com)
2. Navigate to Developers → API keys
3. Copy your publishable and secret keys
4. Store them securely in your environment

```bash theme={null}
# Example environment variables
STRIPE_PUBLISHABLE_KEY=pk_test_...
STRIPE_SECRET_KEY=sk_test_...
```

### 2. Configure Webhooks

1. Go to Developers → Webhooks in your Stripe Dashboard
2. Add an endpoint URL
3. Select events to monitor
4. Save your webhook signing secret

```json theme={null}
{
  "webhook_endpoint": {
    "url": "https://your-domain.com/stripe/webhook",
    "secret": "whsec_..."
  }
}
```

### 3. Install Dependencies

Add the required dependencies to your project:

```json theme={null}
{
  "dependencies": {
    "@stripe/stripe-js": "^1.54.0",
    "@stripe/stripe-node": "^12.0.0"
  }
}
```

### 4. Initialize Configuration

Set up your configuration file:

```json theme={null}
{
  "stripe": {
    "apiVersion": "2023-10-16",
    "publishableKey": "pk_test_...",
    "secretKey": "sk_test_...",
    "webhookSecret": "whsec_...",
    "environment": "test"
  }
}
```

## Environment Setup

### Development Environment

```json theme={null}
{
  "stripe": {
    "environment": "test",
    "apiKey": "sk_test_..."
  }
}
```

### Production Environment

```json theme={null}
{
  "stripe": {
    "environment": "production",
    "apiKey": "sk_live_..."
  }
}
```

## Security Best Practices

1. Never expose secret keys in client-side code
2. Use environment variables for sensitive data
3. Implement proper key rotation
4. Use webhook signatures for verification
5. Follow PCI compliance guidelines

## Testing the Installation

1. Make a test API call:

```json theme={null}
{
  "test": {
    "type": "stripe.createPaymentIntent",
    "params": {
      "amount": 1000,
      "currency": "usd"
    }
  }
}
```

2. Verify webhook reception:

```json theme={null}
{
  "test": {
    "type": "stripe.webhook",
    "event": "payment_intent.succeeded"
  }
}
```

## Troubleshooting

Common issues and solutions:

* API key errors: Verify key permissions
* Webhook failures: Check endpoint URL and signature
* Authentication errors: Confirm API version
* Network issues: Check SSL configuration