Developer Ecosystem

Developer Portal

REST APIs, gRPC endpoints, SDKs, and sandbox environments for integrating payment gateways, Amharic AI tools, and enterprise ledgers.

Open API Reference Read Platform Documentation

Quick Start

Integrate Ethiopian Payments in 5 Minutes

Our unified payment SDK handles mTLS encryption, Telebirr RSA signatures, CBE Birr callbacks, and National Bank of Ethiopia compliance out of the box.

API Keys & HMAC Authentication

Bearer token authentication with SHA-256 HMAC signature verification on webhooks.

Sandbox Environment

Test Telebirr & CBE Birr payments instantly using mock test numbers without real money transfers.

99.9% Uptime High-Availability API

Multi-region failover servers in Addis Ababa and Frankfurt with sub-200ms latency.

checkout_integration.ts

TypeScript SDK

// Initialize Zemen Telebirr & CBE Payment Client
import { ZemenPaymentClient } from '@zemen/payments';

const client = new ZemenPaymentClient({
  apiKey: process.env.ZEMEN_API_KEY,
  environment: 'sandbox', // 'production'
});

// Create payment checkout session
const session = await client.payments.createSession({
  amount: 1500.00, // ETB
  currency: 'ETB',
  merchantOrderId: 'INV-2026-0891',
  callbackUrl: 'https://your-domain.com/api/webhooks/zemen',
  paymentMethods: ['telebirr', 'cbe_birr', 'chapa'],
  customer: {
    name: 'Abebe Bikila',
    phone: '+251911223344',
  },
});

console.log('Redirect user to:', session.checkoutUrl);