Introduction

Embermind is an antifraud platform designed for payment processing companies. It provides real-time transaction risk scoring, customer behavior analysis, and fraud detection capabilities.

What is Embermind?

Embermind Antifraud System helps you:

Detect fraud in real-time — Score each transaction before processing
Group customers intelligently — Automatically link transactions to the same person across multiple identifiers (email, phone, card, fingerprint, IP)
Configure custom scoring rules — Tailor fraud detection to your specific business needs
Monitor suspicious activity — Set up alerts for anomalies and suspicious patterns
Collect browser fingerprints — Identify devices and detect bots/emulators
Calculate commissions — Track processing fees per gate and bank

Key Concepts

Concept	Description
Transaction	A payment or withdrawal attempt sent to Embermind for risk scoring
Customer	A unique user profile, automatically created by grouping transactions with matching attributes
Gate	A payment gateway through which transactions are processed
Cascade	A sequence of gates used as fallback for transaction processing
Risk Score	A numerical value indicating the likelihood of fraud
Alert	A notification triggered when suspicious patterns are detected

API Overview

The Embermind API is REST-based and uses JSON for request/response bodies.

Base URL:

https://api.embermind.ch

Main Endpoints:

Category	Endpoint	Description
Transactions	`POST /api/v1/client/transaction-process`	Submit transaction for risk scoring
Customers	`POST /api/v1/client/customers`	Query customer profiles
Alerts	`POST /api/v1/client/alerts`	Manage fraud alerts
Configuration	`POST /api/v1/client/company-settings/update`	Update company settings

Getting Your Credentials

To start using Embermind API, contact your account manager to obtain:

{
    "companyId": "7992110d-617e-40c5-82323b9a-94e8248ad2f1",
    "companyTitle": "Your_Company",
    "apiKeyId": "787987b3-7884c-4888-95183-a9889777e",
    "apiKeyTitle": "root",
    "apiKeyValue": "your-api-key-value"
}

The apiKeyValue is used in the x-api-key header for all API requests.

Access Control

Embermind uses role-based access control (RBAC):

Users — Individual accounts with login credentials
Permission Groups — Collections of permissions that can be assigned to users
Permissions — Granular access rights to specific API endpoints and features

One user can belong to multiple permission groups. The effective permissions are the union of all assigned groups.

Next Steps

Quick Start — Make your first API request in 5 minutes
Authentication — Learn about API Key and Access Token authentication