Changelog

All notable changes to the NahuPay API and SDKs. Subscribe to announcements to get these by email.

API v2 beta

June 28, 2026

API v2 is in public beta. v1 remains fully supported through December 2026.

  • NewCursor-based pagination on all list endpoints — replaces offset pagination.
  • Newpayment_method filter on GET /v2/payments: method=telebirr|mpesa|bank_transfer.
  • Improved40% average reduction in response time on payments.list.
  • Newpayment.processing event fires when funds are in transit (before confirmed).
  • NewpaymentLinks.create() endpoint — create reusable checkout links via API.
  • Breakingoffset parameter removed from list endpoints (use after cursor instead).

v1.3

May 20, 2026

Payment Links, QR code enhancements, and webhook improvements.

  • NewPayment Links — create shareable checkout URLs from the dashboard or via API.
  • NewQR code SVG / PNG data URI returned on payment.create (qr_code field).
  • NewwebhookEndpoints.deliverEvent() — manually replay any event via API.
  • ImprovedWebhook retry backoff now uses full jitter to reduce thundering-herd on redeployments.
  • Fixedpayment.expired event was not firing when the customer navigated away without paying.

v1.2

May 2, 2026

M-Pesa beta, CBE Birr GA, and SDK updates.

  • NewM-Pesa support enters closed beta — request access from the dashboard.
  • NewCBE Birr is now generally available on all plans.
  • Newidempotency_key parameter on payments.create — safely retry network errors.
  • ImprovedNode.js SDK v1.2: autoPaginate() generator for list endpoints.
  • ImprovedPython SDK v1.2: AsyncNahuPay client for asyncio and ASGI frameworks.
  • FixedPHP SDK: constructEvent() incorrectly rejected valid signatures with trailing newline.

v1.0

April 14, 2026

General availability. NahuPay is now open to all Ethiopian businesses.

  • Newpayments.create, retrieve, and list endpoints — stable API.
  • NewTeleBirr USSD push payments — live in production.
  • NewBank transfer via CBE, Awash, Dashen, and Abyssinia banks.
  • NewWebhook delivery with HMAC-SHA256 signatures.
  • NewOfficial SDK releases: Node.js, Python, PHP, Java.
  • NewSandbox environment with test phone numbers for all TeleBirr outcomes.
← PreviousWebhooks guide