Tutorial / 7 min read / 2026-07-19

Send Fraud Events to Naiza

Build the event ingest call, include session context, and use the returned decision in your product workflow.

Start by sending one event from a high-value workflow. A payment event is a useful first integration because it naturally carries customer, device, amount, currency, and session context.

Send the Event

POST /api/v1/events
x-api-key: naiza_api_sk_live_...
Content-Type: application/json

{
  "eventName": "payment.completed",
  "eventCategory": "TRANSACTION",
  "customer": { "externalId": "user_123456" },
  "device": { "externalId": "device_abc123" },
  "sessionId": "session_xyz789",
  "metadata": { "amount": 250, "currency": "SAR" }
}

Use the Decision

  • Persist the event id returned by Naiza for support and investigation workflows.
  • Use ALLOW to continue the product flow immediately.
  • Use REVIEW to add friction or queue the event for operations.
  • Use BLOCK only for rules where your team is comfortable stopping the action automatically.

Read the API docs after your first staging event succeeds.