> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# FraudLabs Pro

> FraudLabs Pro is an online payment fraud detection service that helps merchants minimize chargebacks and maximize revenue by detecting fraud across various payment methods.

![FraudLabs Pro logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/fraudlabs_pro.png?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=22e83c6e5cc5474cf90a5b8c99007b17)

* **Category:** security & identity tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 8
* **Triggers:** 0
* **Slug:** `FRAUDLABS_PRO`
* **Version:** 20261030\_00

## Tools

> [accordion] Create FraudLabs Pro Reseller Sub-Account
>
> **Slug:** `FRAUDLABS_PRO_CREATE_ACCOUNT`
>
> Creates a new FraudLabs Pro user account under a reseller account. Requires a Reseller API key (not a regular API key). Use this action to provision new sub-accounts for customers when operating as a FraudLabs Pro reseller. Returns account credentials (username and password) upon successful creation. Prerequisites: - Must have a FraudLabs Pro Reseller account (apply at [https://www.fraudlabspro.com/reseller/program](https://www.fraudlabspro.com/reseller/program)) - Requires valid Reseller API key (different from standard FraudLabs Pro API key) - All required fields must contain valid data matching FraudLabs Pro validation rules Important: - Phone numbers should contain only digits (no +, -, spaces, or parentheses) - Country must be valid ISO 3166-1 alpha-2 code (e.g., US, GB, CA) - Industry must be a valid ID from 1-14
>
> #### Input Parameters
>
> **fax** `string`
>
> Fax number (digits only, no special characters). Optional.
>
> **key** `string` *required*
>
> FraudLabs Pro Reseller API key (different from regular API key). Required for account creation. Apply at [https://www.fraudlabspro.com/reseller/program](https://www.fraudlabspro.com/reseller/program)
>
> **city** `string` *required*
>
> City name for the billing address
>
> **name** `string` *required*
>
> Full name of the account holder (first and last name)
>
> **email** `string` *required*
>
> Email address for the new account. Used for login and communications.
>
> **phone** `string` *required*
>
> Contact phone number (digits only, no special characters or spaces)
>
> **state** `string` *required*
>
> State or province name/code for the billing address
>
> **format** `string ("json" | "xml")`
>
> Response format (json or xml). Defaults to json for structured data.
>
> **company** `string` *required*
>
> Company or organization name for the account
>
> **country** `string` *required*
>
> ISO 3166-1 alpha-2 country code (2-letter code). See [https://www.fraudlabspro.com/developer/reference/country-codes](https://www.fraudlabspro.com/developer/reference/country-codes)
>
> **address1** `string` *required*
>
> Primary street address (building number and street name)
>
> **address2** `string`
>
> Secondary address line (apartment, suite, unit, floor, etc.). Optional.
>
> **industry** `string` *required*
>
> Industry classification ID (1-14). Options: 1=Retail(e-Commerce), 2=Retail(Brick\&Mortar), 3=Hospitality, 4=Ticketing, 5=Clubs, 6=Memberships, 7=Digital Content, 8=Online Games, 9=Software, 10=Telecom, 11=Travel, 12=Non-Profit, 13=Services, 14=High Risk
>
> **username** `string` *required*
>
> Desired username for the new FraudLabs Pro account. Must be unique across all accounts.
>
> **zip\_code** `string` *required*
>
> Postal code or ZIP code for the billing address
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] FLP Feedback Order
>
> **Slug:** `FRAUDLABS_PRO_FLP_FEEDBACK_ORDER`
>
> Submit fraud screening feedback to improve FraudLabs Pro's machine learning model. Use this after reviewing a screened order to mark it as approved, rejected, or blacklisted. This feedback trains the algorithm to better detect fraud patterns in future transactions.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The fraudlabspro\_id returned from a Screen Order API call. This identifies which transaction to provide feedback for.
>
> **key** `string` *required*
>
> Your FraudLabs Pro API license key.
>
> **note** `string`
>
> Optional internal note explaining the reason for this feedback decision (e.g., 'Customer verified by phone', 'Known fraudster pattern').
>
> **action** `string ("APPROVE" | "REJECT" | "REJECT_BLACKLIST")` *required*
>
> Feedback action: APPROVE (legitimate transaction), REJECT (fraudulent), or REJECT\_BLACKLIST (fraudulent and add to permanent blacklist for enhanced future detection).
>
> **format** `string ("json" | "xml")`
>
> Response format. Defaults to 'json'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] FraudLabs Pro Screen Order
>
> **Slug:** `FRAUDLABS_PRO_FLP_SCREEN_ORDER`
>
> Tool to screen orders for fraud. Use when you need to assess transaction risk before fulfillment.
>
> #### Input Parameters
>
> **ip** `string` *required*
>
> Transaction IP address (IPv4 or IPv6)
>
> **email** `string`
>
> User's email address
>
> **amount** `string`
>
> Transaction amount (must be positive)
>
> **bin\_no** `string`
>
> First 6 or 8 digits of card for bank identification
>
> **format** `string ("json" | "xml")`
>
> Response format
>
> **currency** `string`
>
> Transaction currency (ISO-4217 code, e.g., USD)
>
> **quantity** `integer`
>
> Total quantity of items
>
> **username** `string`
>
> Username used for signup
>
> **bill\_addr** `string`
>
> Billing street address
>
> **bill\_city** `string`
>
> Billing city
>
> **card\_hash** `string`
>
> SHA2 hash of card number
>
> **last\_name** `string`
>
> User's last name
>
> **ship\_addr** `string`
>
> Shipping street address
>
> **ship\_city** `string`
>
> Shipping city
>
> **avs\_result** `string`
>
> Single-character AVS result from processor
>
> **bill\_state** `string`
>
> Billing state or province (US/CA code, e.g., NY)
>
> **cvv\_result** `string`
>
> Single-character CVV2 result (processor response)
>
> **department** `string`
>
> Merchant product/service department ID
>
> **email\_hash** `string`
>
> SHA2 hash of email if email not provided
>
> **first\_name** `string`
>
> User's first name
>
> **ship\_state** `string`
>
> Shipping state or province (US/CA code, e.g., NY)
>
> **user\_phone** `string`
>
> User's phone number
>
> **bill\_country** `string`
>
> Billing country ISO-3166 alpha-2 code (e.g., US)
>
> **email\_domain** `string`
>
> Email domain; auto-extracted if email provided
>
> **flp\_checksum** `string`
>
> Device validation checksum from FraudLabs Pro JavaScript
>
> **payment\_mode** `string ("creditcard" | "paypal" | "cod" | "bankdeposit" | "giftcard" | "crypto" | "wired" | "others")`
>
> Payment mode for transaction
>
> **ship\_country** `string`
>
> Shipping country ISO-3166 alpha-2 code (e.g., US)
>
> **bill\_zip\_code** `string`
>
> Billing postal or ZIP code
>
> **ship\_zip\_code** `string`
>
> Shipping postal or ZIP code
>
> **user\_order\_id** `string`
>
> Merchant's order ID (max 15 chars)
>
> **ship\_last\_name** `string`
>
> Shipping recipient last name
>
> **payment\_gateway** `string`
>
> Payment gateway name
>
> **ship\_first\_name** `string`
>
> Shipping recipient first name
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get FraudLabs Pro Order Result (v2)
>
> **Slug:** `FRAUDLABS_PRO_GET_ORDER_RESULT2`
>
> Tool to retrieve an existing transaction from FraudLabs Pro fraud detection system using the v2 API. This API is only available for paid plans.
>
> #### Input Parameters
>
> **id** `string`
>
> FraudLabs Pro transaction ID (fraudlabspro\_id) or your platform's order ID (user\_order\_id). Required unless retrieving without specific ID.
>
> **key** `string`
>
> FraudLabs Pro API key. If not provided, will use key from authentication metadata.
>
> **format** `string ("json" | "xml")`
>
> Response format; json (default) or xml
>
> **id\_type** `string ("FraudLabsPro::ID" | "FraudLabsPro::UserOrderID")`
>
> Type of ID provided in the 'id' parameter. Use FraudLabsPro::ID for FraudLabs Pro transaction IDs or FraudLabsPro::UserOrderID for your order IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get SMS Verification Result
>
> **Slug:** `FRAUDLABS_PRO_GET_SMS_VERIFICATION_RESULT`
>
> Verify an OTP (one-time password) received via SMS. Returns 'Y' if the OTP is valid, 'N' if invalid or expired. Must be called after using Send SMS Verification to obtain a transaction ID.
>
> #### Input Parameters
>
> **key** `string` *required*
>
> FraudLabs Pro API key
>
> **otp** `string` *required*
>
> The one-time password (OTP) code received by the user via SMS that needs to be verified
>
> **format** `string ("json" | "xml")`
>
> Response format, 'json' (default) or 'xml'
>
> **tran\_id** `string` *required*
>
> Unique transaction ID returned by the Send SMS Verification API
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send SMS OTP Verification
>
> **Slug:** `FRAUDLABS_PRO_SEND_SMS_VERIFICATION`
>
> Sends an SMS message containing a one-time password (OTP) to verify a user's phone number. The API generates a random 6-digit OTP, replaces the \<otp> placeholder in your message template, and sends the SMS to the recipient. Returns a transaction ID that you must use with the Get SMS Verification Result action to verify the OTP the user enters. Testing: Use phone number '+11' for sandbox testing (no credits deducted). For verification testing with sandbox number, use OTP '123456'.
>
> #### Input Parameters
>
> **key** `string` *required*
>
> FraudLabs Pro API key
>
> **tel** `string` *required*
>
> Recipient mobile number in E.164 format, e.g., +12015550123
>
> **mesg** `string` *required*
>
> SMS message template; must include \<otp> placeholder; max 140 characters
>
> **format** `string ("json" | "xml")`
>
> Response format: json (default) or xml
>
> **otp\_timeout** `integer`
>
> OTP timeout in seconds; default 3600; min 15; max 86400
>
> **country\_code** `string`
>
> ISO 3166 country code for the phone, e.g., US
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Subscribe Reseller Plan
>
> **Slug:** `FRAUDLABS_PRO_SUBSCRIBE_PLAN`
>
> Tool to subscribe a reseller account to a specific plan. Use after obtaining a reseller API key and selecting a plan. Example: Subscribe user "john\_doe" to the MICRO plan.
>
> #### Input Parameters
>
> **key** `string` *required*
>
> Your Reseller API key.
>
> **plan** `string ("MICRO" | "SMALL" | "MEDIUM" | "LARGE" | "ENTERPRISE")` *required*
>
> Plan code. Only MICRO plan is currently accepted.
>
> **format** `string ("json" | "xml")`
>
> Response format. Valid values: json, xml. Default is json.
>
> **username** `string` *required*
>
> Username of the account to subscribe.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Test Order Status Changed Webhook Delivery
>
> **Slug:** `FRAUDLABS_PRO_WEBHOOK_ORDER_STATUS_CHANGED`
>
> Tool to send a test webhook payload to the provided callback URL for FraudLabs Pro order status change notifications. This helps validate your endpoint behavior. Important: FraudLabs Pro webhook registration must be configured manually via dashboard.
>
> #### Input Parameters
>
> **test\_id** `string`
>
> Test transaction id to include in the webhook payload
>
> **test\_action** `string ("APPROVE" | "REJECT")`
>
> FraudLabs Pro status to include in the webhook payload
>
> **callback\_url** `string` *required*
>
> URL to receive FraudLabs Pro order status change notifications
>
> **extra\_fields** `object`
>
> Additional key/value pairs to include in the payload
>
> **payload\_format** `string ("form" | "json")`
>
> Payload encoding format for the test webhook POST
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
