Arifpay Integration Guide

Arifpay is a leading National Bank of Ethiopia (NBE) licensed payment system operator (PSO) offering multi-rail mobile money and card processing.

---

Capabilities

Feature	Supported	Notes
Omnichannel Checkout	✅ Yes	Single checkout session for Telebirr, CBEBirr, Awash, HelloCash
Currencies	ETB, USD	Supported
QR Code / POS Terminal	✅ Yes	In-store dynamic QR generation
Sandbox Environment	✅ Yes	gateway.arifpay.net/api/sandbox

---

Configuration

{
  "api_key": "ARIFPAY_API_KEY",
  "environment": "sandbox"
}

---

Initiating a Charge

TypeScript

import { Zirzir } from '@zirzir/sdk';

const zirzir = new Zirzir({
  baseUrl: 'http://localhost:8080',
  apiKey: process.env.ZIRZIR_API_KEY!,
});

const tx = await zirzir.charge({
  provider: 'arifpay',
  amount: 250,
  currency: 'ETB',
  txRef: 'ORD-ARIF-101',
  phone: '0911223344',
});

console.log('Arifpay Session URL:', tx.paymentUrl);