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.