Documentation
Everything you need to integrate Fidro, protect your signups, and prevent chargebacks.
API Reference
Endpoints, parameters, responses, and an interactive playground
Guides
Getting Started
Set up Fidro and make your first API call.
Quickstart Guide
Go from zero to validating your first email in under 5 minutes.
3 min readAdd Fidro to Your Signup Form
Validate emails and IPs at registration to block fraud before it starts.
5 min readUsing Test Mode
Use test API keys and predefined scenarios to build and test your integration without affecting real data.
3 min readCore Concepts
Understand how Fidro analyses risk and scores users.
How Risk Scoring Works
Understand how Fidro calculates a 0–100 risk score from multiple fraud signals.
7 min readUnderstanding Check Results
A detailed breakdown of every check Fidro runs and what each result means for your business.
6 min readEmail vs IP Validation: When to Use Each
Learn when to validate emails, IPs, or both for the best fraud coverage.
3 min readChargeback Prevention
Protect your Stripe payments from fraud and disputes.
Setting Up Stripe Chargeback Prevention
Connect your Stripe account to Fidro for automatic chargeback risk analysis and dispute handling.
8 min readPassing Customer Metadata to Stripe
How to include email, IP, and enhanced metadata in Stripe payments for better chargeback risk scoring.
6 min readConfiguring Auto-Refund Rules
Set up automatic refunds for high-risk transactions and disputes to prevent chargebacks.
4 min readUnderstanding Chargeback Disputes
What happens when a customer disputes a charge, and how Fidro helps you respond.
5 min readDashboard & Settings
Navigate the Fidro dashboard and configure your account.
Reading the Transactions Page
Navigate the transactions dashboard to monitor payments, risk scores, and dispute status.
3 min readManaging Custom Blocklists
Create and manage blocklist entries to instantly block known bad actors.
3 min readUnderstanding Audit Logs
Track every API request with full request/response details for debugging and compliance.
3 min readTroubleshooting
Fix common issues and understand error messages.
Common Error Codes and How to Fix Them
Diagnose and fix the most common API errors you might encounter.
4 min readRate Limits and Quotas
Understand per-minute rate limits and monthly quotas, and how to handle them gracefully.
3 min readStripe Webhook Not Working
Diagnose and fix issues with Stripe webhooks not reaching Fidro.
3 min readRisk Score FAQ
Answers to common questions about risk scores, false positives, and threshold tuning.
4 min readBuilding with AI?
Our docs are available as plain markdown for AI coding assistants.
Append .md to any docs guide or blog post URL to get a plain text version that AI tools like Claude, Cursor, and GitHub Copilot can read directly. For example:
https://fidro.io/docs/guides/quickstart.md
We also provide llms.txt and llms-full.txt files for AI crawlers, with a complete overview of the Fidro API, endpoints, and integration examples.