Registration Event

The registration event type is used when a new user account is being created. This helps detect fake account creation, bot registrations, and fraud farm activity.

Category: Non-monetary Relevant feedback outcomes: success, fail, fraud, rejected

note

Dispute, chargeback, and refund outcomes do not apply to registration events.

Request Example

POST /api/v1/generic/validate HTTP/1.1
Host: api.sa.mubeen.ai
X-API-Key: <your_key>
Content-Type: application/json

{
  "event_type": "registration",
  "timestamp": "2025-03-15T12:30:00Z",
  "attempt_id": "att_reg_3310",
  "external_id": "reg_112233",
  "device_id": "fp_newuser_xyz98765",
  "user_id": "usr_new_789012",
  "user_email": "[email protected]",
  "full_name": "Omar Al-Sheikh",
  "phone_number": "+971578901234",
  "ip_address": "91.200.55.12",
  "ip_country": "AE",
  "user_agent": "Mozilla/5.0 (Linux; Android 14; Pixel 8)",
  "channel": "web",
  "platform": "web",
  "account_created_at": "2025-03-15T12:30:00Z"
}

Response Example

{
  "request_id": "b2c3d4e5-0002-4567-8901-bcdef0123456",
  "decision": "challenge",
  "risk_score": 42,
  "risk_level": "medium"
}

Feedback Examples

Successful Registration

{
  "request_id": "b2c3d4e5-0002-4567-8901-bcdef0123456",
  "outcome": "success",
  "external_id": "reg_112233"
}

Fraudulent Registration (Fake Account)

{
  "request_id": "b2c3d4e5-0002-4567-8901-bcdef0123456",
  "outcome": "fraud",
  "outcome_details": {
    "fraud_type": "fake_account",
    "detection_method": "device_farm_detection",
    "shared_device_count": 15
  },
  "external_id": "reg_112233"
}

Rejected Registration

{
  "request_id": "b2c3d4e5-0002-4567-8901-bcdef0123456",
  "outcome": "rejected",
  "outcome_details": {
    "rejection_reason": "disposable_email",
    "rule_triggered": "email_domain_blocklist"
  },
  "external_id": "reg_112233"
}

Key Fields for Registration Events

Field	Importance	Notes
user_email	Required	Disposable or suspicious email domains indicate risk
device_id	Recommended	Multiple registrations from same device indicate fraud farms
ip_address	Recommended	Shared IPs across many registrations indicate bot activity