Fidro + Ruby Integration

Overview

To integrate Fidro with Ruby, use the HTTParty gem to send a POST request to the Fidro API with the user's email and IP address. Fidro returns email validation results, disposable email detection, IP geolocation, and a fraud risk score in a single JSON response. The integration is straightforward — HTTParty handles the HTTP request and JSON parsing with minimal code.

Fidro is a fraud detection API that combines email validation, IP intelligence, geolocation analysis, and Stripe chargeback prevention in a single API call. It returns a risk score with a clear recommendation — allow, review, or block — so you can stop fraud without building your own scoring logic.

2. Email Validation

Send a POST request to Fidro's /v1/validate endpoint with the user's email address and optional IP. Fidro validates the email, checks for disposable domains, analyzes the IP for VPN/proxy/Tor usage, and returns a risk score with a clear recommendation — allow, review, or block.

require "httparty"

FIDRO_API_KEY = ENV["FIDRO_API_KEY"]

def validate_email(email, ip)
  response = HTTParty.post(
    "https://api.fidro.io/v1/validate",
    headers: {
      "Authorization" => "Bearer #{FIDRO_API_KEY}",
      "Content-Type"  => "application/json",
    },
    body: { email: email, ip: ip }.to_json
  )

  unless response.success?
    raise "Fidro API error: #{response.code} #{response.message}"
  end

  result = response.parsed_response

  puts "Risk score: #{result['data']['risk_score']}"
  puts "Recommendation: #{result['data']['recommendation']}"
  result
end

# Usage
result = validate_email("test@example.com", "8.8.8.8")
puts result