An event defines the business scenario where you want Fraud Detection to apply risk control—for example, detecting fraudulent account registrations, processing loan applications, or flagging marketing abuse. Creating an event is the first step to building a risk control workflow in the decision engine.
Key concepts
Event
Event code: When you create an event, the system generates a unique event code. Pass this code in your API request to route the request to the correct policy set in the decision engine, which evaluates the request and returns a risk result.
Event fields
Prerequisites
Before you begin, ensure that you have:
Access to the Fraud Detection console
(Optional) Custom fields defined in the field management module, if you plan to add custom fields to the event
Create an event
Step 1: Open the Event Management page
Log on to the Fraud Detection console.
In the left-side navigation pane, choose Decision Engine > Event Management.
Click Create Event.
Step 2: Configure basic information
| Field | Description |
|---|---|
| Event Name | A name that reflects the business scenario, such as account_registration or loan_application. The name cannot be changed after the event is created. |
| Event Description | Background information or context for the event. Helps you identify and understand the event in later operations. |
Step 3: Configure event fields
Event fields describe the data your system sends with each request. Policies use these fields to make risk decisions, so include the fields that matter most to your scenario.
Add fields using one of the following methods:
Select a template: Choose a template from the drop-down list and click Add to Table
Add preset fields (recommended): Click Add Self-Customized Field and enter a keyword to find fields by fuzzy match. The decision engine provides many preset fields commonly used in risk control.
Create a custom field: Click the + icon, then click the field in the Field name/display name column. In the list that appears, click New field. In the New field panel, configure the field name, display name, and type.
Note: Before adding a custom field, define it first in the field management module.
To remove a field, click Delete in the Actions column and click OK
Step 4: Submit
Click Submit. The event is created and you are returned to the Event Management page.
Copy the event code generated for the event. Pass this code in your API calls to route requests through the decision engine.
What's next
Configure risk control policies for the event in the decision engine.
Pass the event code in your integration requests to start evaluating risk.