For Agents
Score an order for fraud risk in real time, send post-transaction feedback to improve the model, and run SMS step-up verification when needed. Authentication is an API key in the 'key' query or body parameter.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the FraudLabs Pro API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with FraudLabs Pro API API.
Score an order for fraud risk via /order/screen with billing, shipping, IP, and payment fields
Retrieve a previously screened order's verdict and signals via /order/result
Send post-transaction feedback (approved, rejected, chargeback) via /order/feedback to improve the model
Trigger an SMS verification code to a customer phone via /verification/send
GET STARTED
Use for: I need to score this checkout order for fraud risk, Send a chargeback feedback signal for an order I screened last week, Trigger an SMS verification code to a customer to confirm their phone, Verify the OTP a customer just typed in
Not supported: Does not handle payment processing, refunds, or chargeback dispute filings — use for fraud scoring, post-transaction feedback, and SMS verification only.
FraudLabs Pro screens online transactions for chargeback risk before merchants commit to fulfilment. The version 2 API exposes five endpoints covering real-time order screening, asynchronous order-result retrieval, post-transaction feedback (approved, rejected, chargeback) for model improvement, plus an SMS verification flow for step-up authentication. It returns a numeric fraud score, distance and proxy signals, and a recommended action so merchants can auto-approve, review, or reject.
Confirm an SMS verification code via /verification/result for step-up authentication
Patterns agents use FraudLabs Pro API API for, with concrete tasks.
★ E-Commerce Checkout Risk Scoring
An online store calls /order/screen at checkout with the cart, billing address, shipping address, IP, and payment method. FraudLabs Pro returns a numeric score plus an action recommendation (approve, review, reject) within a few hundred milliseconds, letting the store auto-fulfil low-risk orders and route high-risk ones to manual review.
POST to /order/screen with the order payload and the API key in the 'key' parameter, then branch on the recommended action returned by the API
Closed-Loop Feedback for Model Tuning
After the merchant settles or charges back an order, the integration calls /order/feedback so FraudLabs Pro learns whether its earlier verdict was correct. Sending feedback is what keeps the per-merchant fraud model accurate over time and is the single highest-leverage thing an integrator can do.
POST /order/feedback with the order id and status (APPROVED, REJECTED, or CHARGEBACK) once the bank settles or disputes the transaction
SMS Step-Up Verification
When the screen verdict is REVIEW, the merchant triggers /verification/send to push an OTP to the customer's phone, then confirms the code through /verification/result. A successful OTP softens the risk signal and lets the order proceed without manual review.
POST /verification/send with the customer phone, then on user input POST /verification/result with the otp_code and check the response state
AI Agent Risk Triage
An agent monitoring a checkout queue uses Jentic to score orders, send feedback, and request SMS verification when the score is borderline. The agent never holds the FraudLabs Pro key directly and surfaces a plain-language summary of why each order was approved or flagged.
Search Jentic for 'score an order for fraud risk', load the /order/screen schema, execute against each pending order, and post a triage summary back to operations
5 endpoints — fraudlabs pro screens online transactions for chargeback risk before merchants commit to fulfilment.
METHOD
PATH
DESCRIPTION
/order/screen
Score an order for fraud risk
/order/result
Retrieve a previously screened order's verdict
/order/feedback
Send post-transaction feedback (APPROVED, REJECTED, CHARGEBACK)
/verification/send
Trigger an SMS verification code
/verification/result
Confirm an SMS verification code
/order/screen
Score an order for fraud risk
/order/result
Retrieve a previously screened order's verdict
/order/feedback
Send post-transaction feedback (APPROVED, REJECTED, CHARGEBACK)
/verification/send
Trigger an SMS verification code
/verification/result
Confirm an SMS verification code
Three things that make agents converge on Jentic-routed access.
Credential isolation
The FraudLabs Pro API key is stored encrypted in the Jentic vault. Agents receive a scoped execution token instead of the raw key, so prompt injection or transcript logging cannot leak the credential.
Intent-based discovery
Agents call Jentic search with intents like 'score an order for fraud risk' or 'send chargeback feedback' and Jentic returns the matching FraudLabs Pro operation with its input schema, so the agent does not need to read the developer docs.
Time to first call
Direct FraudLabs Pro integration: 1-2 days to wire screening into checkout and feedback into the order lifecycle. Through Jentic: under 30 minutes — search, load, execute on each of the five endpoints.
Alternatives and complements available in the Jentic catalogue.
FraudLabs Pro Fraud Detection (v1)
Earlier v1 fraud detection API with the same screening concept under /v1/order paths
Use the v2 API for new integrations; the v1 spec is maintained for legacy customers.
Sift
Sift is a higher-end fraud and trust platform with broader event types and ML model controls
Choose Sift when the merchant has large volume and dedicated risk engineering; choose FraudLabs Pro for cost-effective scoring on small to mid-size stores.
Fingerprint
Fingerprint provides a stable visitor identifier that strengthens FraudLabs Pro's IP and device signals
Pair Fingerprint visitor IDs with FraudLabs Pro's order screening to catch returning fraudsters across cleared cookies.
Specific to using FraudLabs Pro API API through Jentic.
What authentication does the FraudLabs Pro API use?
FraudLabs Pro uses an API key passed as the 'key' query or body parameter on every call. Through Jentic, the key is stored encrypted in the vault and substituted at execution time, so the raw key never enters the agent's context.
Can I score an order for fraud risk with the FraudLabs Pro API?
Yes. POST to /order/screen with the order payload — billing address, shipping address, customer IP, payment method, item list, and amounts. The response includes a numeric fraud score, a recommended action, and risk signals such as IP geolocation and proxy detection.
What are the rate limits for the FraudLabs Pro API?
FraudLabs Pro applies per-plan monthly transaction quotas rather than per-second rate limits, with the free Micro plan allowing a few hundred screens per month and paid plans scaling into the millions. Quota is enforced on /order/screen calls; feedback and result retrieval do not count.
How do I send chargeback feedback through Jentic?
Search Jentic for 'send fraud feedback', load the /order/feedback schema, and execute it with the order_id from the original screen call plus the status set to CHARGEBACK. This retrains the per-merchant fraud model so future screens are more accurate.
Is the FraudLabs Pro API free?
FraudLabs Pro offers a free Micro plan with a small monthly screen allowance, plus paid Mini, Small, Medium, and Large plans that scale by transaction volume and include faster support. SMS verification is billed per message in addition to the screen quota.
How do I run SMS step-up verification on a borderline order?
When /order/screen returns a REVIEW recommendation, POST /verification/send with the customer's phone number to deliver an OTP, then POST /verification/result with the user-entered code. A successful verification softens the risk score and lets the order proceed without human review.