Almara Pay Documentation
    • Introduction
    • Definitions
      • Data Types
      • Error Codes
      • MCCMNC Codes
    • Authorization
      • Overview
      • Token Request
        POST
      • Find Transaction Routes
        GET
      • Health Check
        GET
    • Payouts
      • Overview
      • Payment Order Request Information
      • Mobile Money Requests
        • Overview
        • Mobile Transfers- Safaricom (M-Pesa)
        • Mobile Transfers - Airtel Money
      • Payment Order Requests - Business Transfers
        POST
      • Payment Order Requests - Bank Transfers
        POST
      • Find Payment Order By OriginatorConversationId
        GET
      • Reject Order By OriginatorConversationId
        POST
    • Pay-Ins
      • Payment Links
        • Overview
        • Create Payment Link
        • Find Payment Links By Id
        • Update Payment Link
      • Express Deposits
        • Overview
        • Express Deposit Request
        • Find Express Deposit By OriginatorConversationId
      • C2B IPN (Callback)
        • C2B IPN Overview
    • Card Payments
      • Overview
      • Checkout Order Request
        POST
      • Query Checkout Request
        GET
      • Checkout Callback Request
        POST
    • Account Validation
      • Overview
      • Account Number Validation Request
        POST
      • Find KYC Status by SystemTraceAuditNumber
        GET
      • Account Validation
        POST
      • Find Account Validation Status by SystemTraceAuditNumber
        GET
    • Platform Services
      • Airtime Purchase
        • Overview
        • Airtime Purchase
        • Find Airtime Purchases By OriginatorConversationId
      • Customer Accounts
        • Balance Check
        • Find Charges By TransactionTypeId
      • Bill Payments
        • Overview
        • Bill Request Validation
        • Bill Request Payment
        • Find Bill Services
        • Find Bill Number By Service Id and Account Number
        • Find Bill Request By Originator Converstion Id
        • Bill Number

    Introduction

    💳 Almara Pay Developer Documentation

    The super platform for seamless payments across Mobile Money and Banking ecosystems.

    Almara Pay provides a high-performance API gateway that enables businesses to integrate with M-PESA, Airtel Money, MTN, and major banking networks through a single, secure integration.

    🏁 Getting Started


    🚀
    Quickstart
    Get your merchant account and make your first API call in under 5 minutes.


    🔐
    Authentication
    Learn how to secure your requests using OAuth 2.0 Bearer tokens.


    📦
    Payment Orders
    Understand the core structures for sending and receiving funds.


    🔄
    Webhooks
    Configure callbacks to receive real-time updates on transaction status.

    ️⚡ Core Capabilities

    📱 Mobile Money

    Direct integration for M-PESA, Airtel Money, MTN, and Vodacom. Optimized for <10s transaction confirmation.

    🏦 Bank Transfers

    Automated settlements and disbursements via Pesalink, EFT, and RTGS directly to local and regional bank accounts.

    ⚡ Bulk Payments

    High-throughput engine designed for payroll, disbursements, and large-scale collections with robust error handling.

    🔐 Security & Auth

    Almara Pay uses industry-standard OAuth 2.0. All requests must include a valid Authorization header.

    🔄 Transaction Lifecycle

    Our asynchronous engine ensures reliability. Use the following states to track your orders:

    Modified at 2026-04-30 06:04:29
    Next
    Data Types
    Built with