HTTP Endpoints

// This runs automatically when Stripe sends webhook events
// Location: convex/http.ts

export default httpRouter;

httpRouter.route({
  path: "/stripe/webhook",
  method: "POST",
  handler: async (request: Request) => {
    const signature = request.headers.get("stripe-signature");
    const body = await request.text();

    try {
      // Verify webhook signature
      const event = stripe.webhooks.constructEvent(
        body,
        signature!,
        process.env.STRIPE_WEBHOOK_SECRET!
      );

      switch (event.type) {
        case 'payment_intent.succeeded':
          // Automatic order creation
          const paymentIntent = event.data.object;
          const metadata = paymentIntent.metadata;
          
          // Create order from cart
          await convex.mutation("customers.cartToOrder.createOrderFromCart", {
            customerId: metadata.customerId,
            storeId: metadata.storeId,
            deliveryAddress: JSON.parse(metadata.deliveryAddress),
            deliveryType: metadata.deliveryType,
            deliveryFee: parseFloat(metadata.deliveryFee),
            paymentMethod: "card",
            paymentIntentId: paymentIntent.id,
            paymentStatus: "paid"
          });
          
          break;

        case 'payment_intent.payment_failed':
          // Handle payment failure
          console.error('Payment failed:', event.data.object);
          break;

        case 'payment_intent.canceled':
          // Handle payment cancellation
          console.log('Payment canceled:', event.data.object);
          break;
      }

      return new Response("Webhook processed", { status: 200 });
    } catch (error) {
      console.error('Webhook error:', error);
      return new Response("Webhook failed", { status: 400 });
    }
  }
});

# Configure webhook endpoint in Stripe Dashboard
# 1. Go to Stripe Dashboard → Webhooks
# 2. Add endpoint: https://your-domain.convex.cloud/stripe/webhook
# 3. Select events:
#    - payment_intent.succeeded
#    - payment_intent.payment_failed  
#    - payment_intent.canceled
# 4. Copy webhook signing secret to environment variables

# Environment variables required:
STRIPE_WEBHOOK_SECRET=whsec_1234567890abcdef...
STRIPE_SECRET_KEY=sk_test_1234567890abcdef...

# Test webhook locally (Stripe CLI required)
stripe listen --forward-to localhost:3000/stripe/webhook

# Trigger test events
stripe trigger payment_intent.succeeded
stripe trigger payment_intent.payment_failed

curl https://your-deployment.convex.cloud/health

const health = await fetch('https://your-deployment.convex.cloud/health');
const message = await health.text();
console.log(message); // "Twigz Backend is healthy!"

fetch('/health')
  .then(response => response.text())
  .then(message => console.log(message));

import requests

response = requests.get('https://your-deployment.convex.cloud/health')
print(response.text)  # "Twigz Backend is healthy!"

const config = await fetch('https://your-deployment.convex.cloud/stripe/config');
const { publishableKey } = await config.json();

// Use with Stripe.js
import { loadStripe } from '@stripe/stripe-js';
const stripe = await loadStripe(publishableKey);

fetch('/stripe/config')
  .then(response => response.json())
  .then(config => {
    console.log('Stripe publishable key:', config.publishableKey);
    // Initialize Stripe with the key
  });

import requests

response = requests.get('https://your-deployment.convex.cloud/stripe/config')
config = response.json()
publishable_key = config['publishableKey']

curl https://your-deployment.convex.cloud/stripe/config

# Install Stripe CLI
# macOS
brew install stripe/stripe-cli/stripe

# Login to Stripe
stripe login

# Forward webhooks to local development
stripe listen --forward-to localhost:3000/stripe/webhook

# In another terminal, trigger test events
stripe trigger payment_intent.succeeded
stripe trigger payment_intent.payment_failed

// Test webhook endpoint locally
const testWebhook = async () => {
  const testPayload = {
    id: "evt_test_123",
    type: "payment_intent.succeeded",
    data: {
      object: {
        id: "pi_test_123",
        amount: 5000, // $50.00
        currency: "usd",
        status: "succeeded",
        metadata: {
          customerId: "c123456789",
          storeId: "j123456789",
          deliveryType: "delivery",
          deliveryFee: "5.00",
          deliveryAddress: JSON.stringify({
            fullAddress: "123 Test St",
            city: "ct123456789",
            area: "ar123456789",
            phoneNumber: "+971501234567"
          })
        }
      }
    }
  };

  const response = await fetch('/stripe/webhook', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'stripe-signature': 'test_signature'
    },
    body: JSON.stringify(testPayload)
  });

  console.log('Webhook response:', await response.text());
};