Skip to main content

v3.0.0 - October 2025

Breaking Changes: v3 is a complete redesign. See Migration Guide for upgrade instructions.

🔴 What You Must Change

1. Base URL Changed

2. Authentication Header Changed

3. Response Structure Changed

All responses now wrapped in standardized format:Before (v2):
After (v3):
Access data via response.data instead of directly from response.

4. Endpoint Paths Changed

5. Error Handling Changed

Before (v2):
After (v3):
Always check response.success boolean first.

✨ What’s New

  • Gift Cards API: Complete gift card delivery system with 100+ products
  • Sandbox Keys: Separate API keys for testing without affecting production balance
  • IP Whitelisting: Enhanced security through dashboard settings
  • Request Tracking: Every request includes unique requestId for debugging
  • Better Errors: Structured error codes with actionable messages
  • Schema Validation: Automatic validation prevents invalid requests

📅 Migration Deadline

v2 will be deprecated on October 30, 2026. Migrate before this date to avoid service disruption.

🔗 Resources


v2.x - Pre-October 2025

August 2025

  • Added sandbox mode for testing
  • Improved error handling and logging

July 2023

  • Initial sandbox implementation
  • Added support for ADSL internet recharge

Earlier

  • Mobile top-ups for Mobilis, Djezzy, Ooredoo
  • Basic transaction tracking
  • Account balance management

Need Help?

Contact Support

Questions about migration? We’re here to help.