Stripe Integration

Payment processing and subscriptions.

Configuration

{
  "credentials": {
    "stripe": {
      "secretKey": "{{env.STRIPE_SECRET_KEY}}",
      "webhookSecret": "{{env.STRIPE_WEBHOOK_SECRET}}"
    }
  }
}

Endpoints

Method	Endpoint	Description
POST	/integrations/stripe/payment-intents	Create payment
POST	/integrations/stripe/customers	Create customer
POST	/integrations/stripe/subscriptions	Create subscription
GET	/integrations/stripe/subscriptions/:id	Get subscription

Actions (for workflows)

createPaymentIntent

{
  "integration": "stripe",
  "action": "createPaymentIntent",
  "params": {
    "amount": 2000,
    "currency": "usd",
    "customer": "cus_123"
  }
}

createCustomer

{
  "integration": "stripe",
  "action": "createCustomer",
  "params": {
    "email": "customer@example.com",
    "name": "John Doe"
  }
}

createSubscription

{
  "integration": "stripe",
  "action": "createSubscription",
  "params": {
    "customer": "cus_123",
    "priceId": "price_456"
  }
}

cancelSubscription

{
  "integration": "stripe",
  "action": "cancelSubscription",
  "params": {
    "subscriptionId": "sub_789",
    "immediately": false
  }
}

Examples

Create Payment Intent

curl -X POST http://localhost:3000/integrations/stripe/payment-intents \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2000,
    "currency": "usd",
    "customer": "cus_123"
  }'

Response:

{
  "id": "pi_123",
  "client_secret": "pi_123_secret_456",
  "amount": 2000,
  "currency": "usd",
  "status": "requires_payment_method"
}

Webhook Receiver

Handle Stripe webhooks:

{
  "webhooks": [{
    "name": "stripe-events",
    "path": "/webhooks/stripe",
    "provider": "stripe",
    "secret": "{{env.STRIPE_WEBHOOK_SECRET}}",
    "actions": [{
      "condition": "{{payload.type}} === 'payment_intent.succeeded'",
      "type": "database",
      "action": "insert",
      "params": {
        "table": "payments",
        "data": {
          "stripe_id": "{{payload.data.object.id}}",
          "amount": "{{payload.data.object.amount}}"
        }
      }
    }]
  }]
}

Workflow Example

{
  "id": "process-order",
  "steps": [
    {
      "id": "create-customer",
      "type": "integration",
      "integration": "stripe",
      "action": "createCustomer",
      "params": {
        "email": "{{input.email}}",
        "name": "{{input.name}}"
      }
    },
    {
      "id": "create-payment",
      "type": "integration",
      "integration": "stripe",
      "action": "createPaymentIntent",
      "params": {
        "customer": "{{steps.create-customer.result.id}}",
        "amount": "{{input.amount}}",
        "currency": "usd"
      }
    }
  ]
}