Merge pull request #93 from FriendlyCaptcha/ri-docs

Risk Intelligence page in docs

Author: gzuidhof

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020-2024 Friendly Captcha GmbH
+Copyright (c) 2020-2026 Friendly Captcha GmbH
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -2,7 +2,7 @@
 
 This is the source code of [Friendly Captcha](https://friendlycaptcha.com)'s [Developer Hub](https://developer.friendlycaptcha.com).
 
-This website uses [Docusaurus 2](https://docusaurus.io/).
+This website uses [Docusaurus 3](https://docusaurus.io/).
 
 ## Am I using V1 or V2
 

docs/api/siteverify.md

@@ -35,9 +35,10 @@ The response body is a JSON object which has a `success` field that tells you wh
   "data": {
     "event_id": "ev_CkK-YXwlFf-15_f", // Unique identifier for the siteverify request.
     "challenge": {
-        "timestamp": "2025-03-18T13:01:25Z", // ISO 8601 timestamp when the captcha challenge was completed.
+        "timestamp": "2026-02-05T13:01:25Z", // ISO 8601 timestamp when the captcha challenge was completed.
         "origin": "https://example.com" // Origin where the challenge happened. This can be empty if unknown.
-    }
+    },
+    "risk_intelligence": null // `null` unless you have enabled Risk Intelligence on your account. See below.
   }
 }
 ```
@@ -94,6 +95,13 @@ It is better to temporarily accept bots or spam than to reject all requests. *Do
 :::
 
 
+## Risk Intelligence
+The `risk_intelligence` field in the successful response is `null` unless you have enabled [*Risk Intelligence on Captcha Challenge*](../risk-intelligence/on-captcha-challenge.md) on your account.
+
+Risk Intelligence allows you to receive risk scores and details about the solver of the request. This can help you make more informed decisions about how to handle the request, and allows you to feed the risk data into your fraud detection systems.
+
+This is a paid add-on feature that is available on **Friendly Captcha Advanced** and **Enterprise** plans.
+
 ## Troubleshooting & Tips
 
 ### `method_not_allowed`

docs/getting-started/verify.md

@@ -48,9 +48,10 @@ The response body is a JSON object which has a `success` field that tells you wh
   "data": {
     "event_id": "ev_CkK-YXwlFf-15_f", // Unique identifier for the siteverify request.
     "challenge": {
-        "timestamp": "2025-03-18T13:01:25Z", // ISO 8601 timestamp when the captcha challenge was completed.
+        "timestamp": "2026-02-05T13:01:25Z", // ISO 8601 timestamp when the captcha challenge was completed.
         "origin": "example.com" // Origin where the challenge happened. This can be empty if unknown.
-    }
+    },
+    "risk_intelligence": null // `null` unless you have enabled Risk Intelligence on your account.
   }
 }
 ```