Integration Tests

Overview

Once your API calls are set up, you'll have to test your integration to ensure everything is working. There are two sides to the coin. First, confirming you're getting a response consistently. Second, understanding what the results mean to make sure they're what you need.
 

API tests

Your development or Q&A teams will likely test your API integration. A detailed Q&A check can help uncover any small errors before they become a problem.

HTTP status codes

It's always good to start with the basics. HTTP status codes can give you an "at a glance" overview of whether communication over the API is working as intended or not.

If everything is working correctly, your API response should include a status code beginning with 2XX. If you see status codes 4XX or 5XX, then something's gone wrong. The API response should also contain a SEON error code to help you get to the bottom of things.

Learn more: Visit the API reference for a complete list of SEON error codes and corresponding HTTP status codes.

Check your code

It's always good practice to double-check your code and the API response you receive. Has everything been formatted correctly? Is SEON receiving and using all data you have sent our way?

Does the API response contain any error codes? Are you receiving all expected data fields within your timeout settings? Does your client-side logic for handling timeouts work correctly? Is the API response being parsed and processed as expected?

While this is a manual process, it's the only way to fix integration errors and catch any minor hiccups before SEON is a part of your everyday processes.

Learn more: You can find code samples for API requests and responses on our API reference pages.

Sample payloads

The best way to be sure everything is working is by sending sample data over the API. We'll also preload sample payloads to your account, which you can refer to when building your own.

These payloads will also let you stress-test your request limits, timeouts, and clients' side logic. You can also use them to test SEON's performance and verify our data.

If you'd prefer to remove any sample data from your account once you've finished testing, our Customer Success team is happy to help.

Note: Our customer success & data team can help you Upload your Historical Data through a batch upload to your account if you prefer not to complete this process over API integration due to limited resources or for technical reasons.

Understanding results

SEON takes a handful of data points and creates hundreds to help you fight fraud. Our data enrichment tools are API-based and take time to collect and analyze the wealth of open-source data that SEON uses. All data is collected in real-time, ensuring you're always up to date.

Data enrichment

You can quickly review the results of SEON's data enrichment tools on the Admin Panel if you're using the Fraud API (or at least two data points enriched through the Manual Page). Head to the Transactions page and click on any transaction to open the Transaction Details page.

Scroll down to find the transaction details widgets that house all the information collected by SEON's APIs. For data enrichment checks, your most important sources will be the IP information widget, the Email Information widget, and the Phone Information Widget.

Learn more: Head to the Transaction Details page to dive deeper into the different widgets and their contents.

The results of our social and digital profile checks will be color-coded so you can quickly check them at a glance.

Learn more: Read the Transaction Details overview to learn about all the information you can find on the Transaction Details page.

How rules affect transactions

Transactions in SEON can be influenced by three rule types: default, custom, and machine learning rules. Rules can change a transaction's fraud score or state.

Rule types

When you first start using SEON, we’ll add a set of rules to your account based on our global experience in fighting online fraud. These rules are known as Default rules and will help you see the benefits of using SEON from day one.

Learn more: Default rules cannot be deleted or edited, but you can adjust the scoring based on your risk appetite – turn them on or off anytime. The Scoring Engine overview will give you a deep dive into rule types and how they work.

You can create custom rules from the get-go. Our team is always happy to offer advice and support on what rules to create or how to set them up properly. Machine learning rules are created by our whitebox machine learning model.

Learn more: Read about how you can use custom rules, rule categories, and machine learning to customize your account.

Fraud scores

In SEON, the fraud score indicates the level of risk associated with a transaction. The higher the score, the more likely a transaction is fraudulent.

Rules can add to and subtract from the fraud score depending on whether they indicate an increase or drop in trust.

For example, a simple rule could subtract 5 points from the score if at least three social profiles were found with the provided email address. Another could add 20 points if the customer is using a VPN to connect.

Learn more: Head over to the Scoring Engine overview for a detailed explanation.

Transaction states

In SEON, transactions can have three states: APPROVE, REVIEW, and DECLINE. A transaction's state is primarily defined by its fraud score. You can configure the thresholds of each state depending on your risk appetite.

Rules can change the state of a transaction as well. If these are triggered, the transaction is set to ACCEPT, REVIEW, or DECLINE, regardless of its fraud score.

Learn more: Find out how to finetune your thresholds and state rules from our Setting page overview.

With your API integration tested and a basic understanding of how SEON handles transactions, you're ready to dive into customizing your setup.