NAMIIS Mock API Integration Guide

Overview

The NAMIIS simulator provides identity verification endpoints for sandbox testing.

Use this guide to integrate authentication, request validation, and failure handling patterns.

Base URL

/api/sandbox/namiis

Authentication

Use sandbox API key credentials from participant settings.

Authorization: Bearer sk_test_***
Content-Type: application/json

Example Verification Request

POST /api/sandbox/namiis/verify

{
  "national_id": "12345678901",
  "first_name": "Aina",
  "last_name": "Kandjii",
  "date_of_birth": "1993-06-20"
}

Example Success Response

{
  "verified": true,
  "confidence_score": 0.97,
  "match_type": "exact",
  "request_id": "req_01hxyz"
}

Error Handling

Expect controlled test errors for:

• invalid payload shape
• unauthorized API keys
• simulated downstream timeouts

Implement retry logic only for transient failures and always preserve audit logs.

Integration Checklist

• Input validation using schema constraints
• PII-safe logging and masking
• Timeout and retry policy defined
• User-facing error messages mapped to failure classes

Related APIs

• NAMQR simulator for payment acceptance flows
• Open banking simulator for account and consent workflows