> ## Documentation Index
> Fetch the complete documentation index at: https://vlyai-1c28d863.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration problems

> Per-integration troubleshooting — Stripe webhooks, OAuth redirects, Resend deliverability.

Each integration has its own failure modes. Common patterns:

## Stripe

<AccordionGroup>
  <Accordion title="Webhook signature mismatch" icon="alert-triangle">
    `STRIPE_WEBHOOK_SECRET` doesn't match the endpoint. Re-copy from Stripe → Webhooks → \[endpoint] → Signing secret. Each endpoint has its own secret.
  </Accordion>

  <Accordion title="Test mode price ID with live keys" icon="alert-triangle">
    Recreate the price in the right mode, or switch keys to match.
  </Accordion>

  <Accordion title="Webhook not arriving" icon="alert-triangle">
    Check the endpoint is reachable (no auth in front of it). For local dev, use the [Stripe CLI](https://stripe.com/docs/stripe-cli) to forward.
  </Accordion>
</AccordionGroup>

## OAuth (Google, GitHub, etc.)

<AccordionGroup>
  <Accordion title="'redirect_uri_mismatch'" icon="alert-triangle">
    The exact redirect URL must match what's registered at the provider. Include protocol; match trailing slash exactly.
  </Accordion>

  <Accordion title="OAuth works in dev, fails in prod" icon="alert-triangle">
    Did you register the production redirect URL at the provider? Each environment needs its own.
  </Accordion>
</AccordionGroup>

## Resend / email

<AccordionGroup>
  <Accordion title="Emails arrive in spam" icon="alert-triangle">
    Verify your domain (SPF, DKIM, DMARC). Don't send from `noreply@`; use `hello@`.
  </Accordion>

  <Accordion title="'Domain is not verified'" icon="alert-triangle">
    Verify in Resend, or send from `onboarding@resend.dev` for testing.
  </Accordion>

  <Accordion title="Bounces" icon="alert-triangle">
    Mark bounced addresses invalid. Stop sending to them — bounces hurt deliverability.
  </Accordion>
</AccordionGroup>

## OpenAI / AI providers

<AccordionGroup>
  <Accordion title="Quota exceeded" icon="alert-triangle">
    Add credit at the provider's billing page.
  </Accordion>

  <Accordion title="Model unavailable" icon="alert-triangle">
    Some models require tier-1+ access. Check the provider's tier requirements.
  </Accordion>

  <Accordion title="Streaming cuts off" icon="alert-triangle">
    `max_tokens` too low, or context window exceeded. Increase or shorten input.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={3}>
  <Card title="Integrations overview" icon="puzzle" href="/integrations/overview">
    All integrations.
  </Card>

  <Card title="Common errors" icon="alert-triangle" href="/troubleshooting/common-errors">
    Auth, type, build errors.
  </Card>

  <Card title="Debugging workflow" icon="bug" href="/troubleshooting/debugging-workflow">
    Systematic approach.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.