webhooks

Handle Stripe Webhook

Handle Stripe webhook events for automatic conversion recording.

Supported Events:

  • checkout.session.completed - One-time purchase completed
  • invoice.payment_succeeded - Subscription payment succeeded
  • charge.refunded - Refund processed (negative conversion)

Metadata Requirements: Include session_id in Stripe metadata to link conversion to attribution:

// In your checkout code:
const sessionId = AIVisibility.getSessionId();

const checkout = await stripe.checkout.sessions.create({
  // ... other params
  metadata: {
    session_id: sessionId,  // Required for attribution
    query_id: "optional"     // Optional
  }
});

Response:

  • 200: Event processed successfully
  • 400: Invalid payload or signature
  • 500: Error processing event
post/api/v1/webhooks/stripe

Request

  • Base URL: https://geo.sig.ai (the document declares no server; this is the origin it was published from)
  • URL: https://geo.sig.ai/api/v1/webhooks/stripe
  • Auth: none declared

Headers

Stripe-Signaturestring

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.