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

- https://flexy-api.oneclickdz.com/v2
+ https://api.oneclickdz.com/v3

2. Authentication Header Changed

- Authorization: your-api-key
+ X-Access-Token: your-api-key

3. Response Structure Changed

All responses now wrapped in standardized format:Before (v2):
{
  "balance": 50000,
  "currency": "DZD"
}
After (v3):
{
  "success": true,
  "data": {
    "balance": 50000,
    "currency": "DZD"
  },
  "meta": {
    "timestamp": "2025-10-29T00:00:00.000Z"
  },
  "requestId": "req_abc123"
}
Access data via response.data instead of directly from response.

4. Endpoint Paths Changed

v2 Endpointv3 Endpoint
/topup/plans/mobile/plans
/topup/send/mobile/send
/topup/check/:id/mobile/check/:id
/plans/internet/internet/products
/topup/sendInternet/internet/send
/account/info/account/balance

5. Error Handling Changed

Before (v2):
{
  "error": "Insufficient balance"
}
After (v3):
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Your balance is insufficient for this operation",
    "details": {
      "required": 1000,
      "available": 500
    }
  },
  "requestId": "req_abc123"
}
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.