Speed it up with API integrations

Overview

Unlock automated fraud prevention while staying in complete control with SEON's APIs. Integrating our APIs is as easy as pie and this process can be completed in a matter of hours. We've collected everything you need to complete technical integration on this page.

 

API basics

Application Programming Interfaces (APIs) help different applications communicate with one another. 

All SEON's APIs follow the REST protocol (REpresentational State Transfer). REST APIs are great for cloud applications because they are based on the Uniform Resource Identifiers (URIs) and HTTP protocols and use JSON for data formatting.

APIs make SEON quick, easy, and painless to integrate with your systems. They work as the connective layer to enable different applications to easily connect together to share data seamlessly. This means that regardless of your current setup and applications used, SEON’s APIs can easily plug and play into your existing workflow.

Simply add an API request when you need information from SEON and create the logic to parse information from the response. 

Take a look at the table below to gauge who you'll have to involve. Time values are estimates and highly dependent on the complexity of your integration:

RoleTime (avg.)Responsibilities
Project manager4–16 hoursDefines use cases (where to integrate SEON) and the API fields to be used in each instance.
Technology decision-maker (CTO, Chief Architect, etc.)1–3 hoursApproves plans and allocates development resources.
Developer(s)6–20 hoursCreates the API request and the logic to parse the response.

 

SEON's APIs

SEON's API-based architecture makes our solution extremely flexible. Integrate different APIs – with various unique parameters and timeouts – to different parts of your user journey. Prevent fraud by using the right tools at the right time.

Our most popular APIs you’ll come across are:

  • Fraud API: SEON’s proprietary modular API combines our email, phone number, and IP APIs with device fingerprinting so that you can request and receive our enriched data, rules, and scoring in a single API call.
  • Email API: Our standalone email enrichment tool that will help you learn about the approximate minimum age of an email address, its provider, and any connected online profiles.
  • Phone API: Unlock insights into a user's phone number's history, and social or digital profiles connected to it, using SEON's standalone phone number enrichment solution.
  • IP API: Identify suspicious VPN and proxy connections and pinpoint users with accurate geolocation information relying on our standalone IP address data enrichment API.
  • Device Fingerprinting: Integrate our JS module or SDK for iOS or Android to learn about the devices your customers are using to access your service. Identify quirky configurations that may hide fraudsters before they can cause any damage.

Which SEON APIs to use

Use the table below to identify which APIs you should use at various touchpoints. Find the corresponding section of the page below for recommended API fields and integration tips.

Recommended APIs for common use cases.

Onboarding

Stop bad actors before they do harm by catching them at registration. Stop fake accounts, multi-accounting, bots, and bonus abuse with SEON. Confirm if new accounts are honest users with digital and social footprint checks using email addresses and phone numbers. Unlock information about their devices and connection with IP address lookup and device fingerprinting tools.

Here's an example setup to get you started. See our full API reference for all possible fields.

Simple integrationFull integration

email and/or phone_number
ip

Account details

user_created
action_type
user_id*

Device Fingerprinting (JS/SDK)

session

User details

user_fullname
user_name
user_dob
password_hash
user_country
user_region
user_city
user_street
user_street2
user_zip
user_category
user_verification_level

Brand details

brand_ID
merchant_ID

Referral details

affiliate_id
affiliate_name

* SEON will create if not provided.

Logins

Fight account takeover (ATO) attempts and protect your business from fraudulent transactions. ATOs can lead to fraudulent purchases and chargebacks, or unauthorized transfers or withdrawal of funds from accounts. Our transaction monitoring powered by our Rules and Scoring Engines makes recommendations to best defend your customers and your business.

Run device fingerprinting and IP address checks to learn where users are logging in and the devices they are using to spot suspicious changes.

Here's an example setup to get you started. See our full API reference for all possible fields.

Simple integrationFull integration

ip

Account details

user_id*
action_type

Device Fingerprinting

session

User information

user_account_status
password_hash

* SEON will create if not provided.

 

Transaction monitoring

Monitor transactions including new orders, funds transfers, and withdrawals with SEON to block fraudulent activity. Use geolocation information, shipping address, payment option details, and device characteristics to uncover questionable purchases and strange account actions.

Here's an example setup to get you started. See our full API reference for all possible fields.

Simple integrationFull integration

ip

Account details

user_id*
action_type

Card details

card_fullname
card_bin
card_hash
card_expire
card_last

Transaction details

transaction_id*
transaction_type
transaction_amount

Device Fingerprinting (JS/SDK)

session

User account details

user_account_status
user_bank_account
user_balance
transaction_currency

Billing details

billing_country
billing_city
billing_region
billing_zip
billing_street
billing_street2
billing_phone

Promotion details

discount_code
bonus_campaign_id

Order details:

sca_method
items
shipping_country
shipping_city
shipping_region
shipping_zip
shipping_street
shipping_street2
shipping_phone
shipping_fullname
shipping_method
details_url
gift

* SEON will create if not provided.

 

Credit scoring

People leave a trail of digital breadcrumbs across the internet as they sign up for services and social media with their email addresses and phone numbers. Unlock this wealth of information to accelerate credit scoring while cutting back on fraud, and lowering your risk indicators.

Run social and digital background checks using our industry-leading data enrichment tools. Unlock more information by providing as many data points as possible to our Email, Phone, and IP APIs.

Here's an example setup to get you started. See our full API reference for all possible fields.

Simple integrationFull integration

ip and/or email and/or phone_number

User details

user_fullname
user_name
user_id*
user_created
user_category
user_account_status
user_bank_account
user_bank_name
user_balance
user_verification_level
user_dob
user_country
user_city
user_region
user_zip
user_street
user_street2
action_type

Receiver details

receiver_fullname
receiver_bank_account

Transaction details

transaction_type
transaction_amount
transaction_currency

Merchant details

merchant_category
merchant_id
merchant_created_at
merchant_country

Referral details

affiliate_id
affiliate_name

Promotion details

discount_code
bonus_campaign_id

* SEON will create if not provided.

 

Using the API Quick Start guide

You can rely on the configurator to give you a head start in building your API request and the logic to extract value from our response. 

The code samples provided are examples. Do not copy and paste them into your integration without customization.

Select the options that apply to your existing infrastructure, your industry, and the use case you are implementing. Then, click Show API references in the top right corner of the configurator.

You will now be forwarded to the corresponding section of the SEON API reference pages. Expand and look through the list of data fields and parameters on the left and browse the sample code and expected formatting on the right.

If you have any difficulty using the configurator, contact our team.

Quick Start

Please select the product you wish to use to quickly set up the optimal payloads for your use-case

Choose your setup

Server
Please choose your backend environment for quick integration
  • cURL
    cURL
  • Java
    Java
  • Python
    Python
  • PHP
    PHP
Industry
Please choose your industry to see relevant example payloads
  • iGaming
    iGaming
  • Ecommerce
    Ecommerce
  • Travel and Ticketing
    Travel and Ticketing
  • Banking and Insurance
    Banking and Insurance
  • Online Lending
    Online Lending
  • Payment Gateways
    Payment Gateways
  • Crypto exchange
    Crypto exchange
Use case
Please choose your use case to see relevant example payloads
  • Register
    Register
  • Login
    Login
  • Deposit
    Deposit
  • Withdrawal
    Withdrawal
  • Payment
    Payment

 

Resources

Everything you may need for integration that is not on this page can be found in one of our integration resources below.

Authentication

Our API uses a standard HTTP Authorization header. This protects your account and the data within it, so only you and SEON can access them.

You must authenticate all API requests using the following format: X-API-KEY: [license_key]

API timeouts

As with all API-based services, timeouts will affect the results you see while using SEON. Read our detailed overview of timeout settings and how timeouts will affect your data enrichment results for more information.

Error codes

When your integration is not working properly, SEON will send error codes in its API response. Use these error messages to better understand what's wrong. Our team is ready to help if anything is unclear.

Device Fingerprinting integration

You can easily integrate our device fingerprinting solutions using our java script agent for browser environments or our SDK for mobile apps. Head over to GitHub to find the code and everything you'll need for integration.

API status

As with all cloud-based tools, our systems can also be affected by internet and server outages. SEON has a 99.99% uptime but if you think something might be wrong on our side, you can check the status of our services on the status page.

Rate limits

We apply limits based on all requests with a specific license key, not individual API requests. Limits are 2 requests/second for trial accounts and 10 requests/second for paid users (by default). Our team can increase your limit on request.

?Got a question

Talk to sales