Skip to content

Getting started

Understand Mozaca's representative integration model for Fedha, Zent, Hazina, access review, base URLs, and the path from product walkthrough to sandbox integration.

GuideUpdated May 28, 2026
GuideUpdated May 28, 2026

Overview

Mozaca documentation is written for teams evaluating Fedha white-label mobile money, Zent digital finance corridors, Hazina treasury operations, partner rails, and controlled-access operating environments.

The public examples are representative: they describe intended API shapes, event states, client boundaries, workspaces, and operating controls used during product, sandbox, and partner scoping.

Live credentials, final schemas, and environment URLs are inserted after access review so product surface, region, rails, and compliance context match the operating model.

Integration path

Most teams start with a product walkthrough, then move into a sandbox review when the operating model is clear.

  1. 01

    Request a walkthrough

    Share product surface, client model, region, rails, expected volume, provider dependencies, and launch timeline.

  2. 02

    Map the operating model

    Confirm identity, ledger, controls, workspaces, evidence, partner dependencies, and readiness boundaries.

  3. 03

    Review sandbox access

    Receive API shape, webhook events, test data, and integration milestones for the selected environment.

  4. 04

    Prepare pilot scope

    Define corridor, monitoring, reporting, and acceptance criteria for the operating scope.

Base URL

Use the environment-specific base URL provided during sandbox review. The examples below use the planned public guide host until approved environments are issued.

Guide base URLhttp
https://api.mozacalabs.com/v1

First request

In the approved API, every authenticated request is sent from your backend, not from client-side browser code. Include an authorization token and an idempotency key for write operations.

Create a transfer examplebash
curl https://api.mozacalabs.com/v1/transfers \
  -X POST \
  -H "Authorization: Bearer MOZACA_SANDBOX_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: tr-demo-001" \
  -d '{
    "source": "wallet_kes_184250",
    "destination": {
      "type": "mobile_money",
      "network": "partner_mobile_money",
      "phone": "+2547..."
    },
    "amount": "2500.00",
    "currency": "KES"
  }'

Related docs