API Reference - Partner Companies

Complete endpoint documentation for partner company operations including product management, balance inquiries, topups, and more.

Endpoints

• Product Categories List — Retrieve available product categories
• Products List — Get detailed product information
• Merchants List — List all merchants under your partner account
• KYC Check — Resolve the Telebirr-registered first name for a customer number before a purchase
• Exchange Rate — Read the current USD → ETB rate before quoting a customer
• Get Balance — Check your current account balance
• Airtime Topup — Process airtime top-up transactions
• Packages Topup — Process package top-up transactions
• Gift APIs — Issue gift vouchers (catalog + generate)
• Gift voucher flow — Partner issuance overview and merchant redemption handoff
• Promos — Access promotional offers
• Webhooks — Configure and manage webhooks

---

For detailed specifications on each endpoint, follow the links above.