Troubleshooting

Symptom: API requests return 401 Unauthorized error.

Solution:

1. Verify the API key is correct and has not expired
2. Check that you're using the correct environment (test vs live)
3. Ensure the API key has the required permissions
4. Regenerate the API key if the issue persists

# Check your API key format
sk_live_... # Live key
sk_test_... # Test key

Learn more in our docs →

Symptom: You signed up but haven't received the confirmation email.

Solution:

1. Check your spam or junk folder
2. Verify the email address you entered
3. Add noreply@florentin.io to your contacts
4. Request a new confirmation email from the login page
5. Contact support if you still don't receive it after 15 minutes

Symptom: Your webhook endpoint is not receiving events.

Solution:

1. Verify your webhook URL is publicly accessible
2. Check that your endpoint returns a 2xx status code
3. Ensure your server accepts POST requests
4. Check the webhook logs in your Florentin dashboard
5. Verify the webhook signature validation is correct

# Test your webhook endpoint
curl -X POST https://your-endpoint.com/webhook \
  -H 'Content-Type: application/json' \
  -d '{"test": true}'

Learn more in our docs →

Symptom: Invoices are not generating or showing incorrect amounts.

Solution:

1. Ensure all usage events have been recorded
2. Check that the billing period is complete
3. Verify the customer has a valid payment method
4. Review product pricing configuration
5. Contact support if amounts seem incorrect

Symptom: API requests return 429 Too Many Requests error.

Solution:

1. Check your current rate limit in the response headers
2. Implement exponential backoff for retries
3. Cache responses where possible
4. Contact support to request a rate limit increase

# Rate limit headers
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1640000000