> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> API updates and breaking changes

## v3.0.0 - October 2025

<Warning>
  **Breaking Changes**: v3 is a complete redesign. See [Migration Guide](/en/migration-from-v2) for upgrade instructions.
</Warning>

### 🔴 What You Must Change

<AccordionGroup>
  <Accordion icon="globe" title="1. Base URL Changed" defaultOpen>
    ```diff theme={null}
    - https://flexy-api.oneclickdz.com/v2
    + https://api.oneclickdz.com/v3
    ```
  </Accordion>

  <Accordion icon="key" title="2. Authentication Header Changed" defaultOpen>
    ```diff theme={null}
    - Authorization: your-api-key
    + X-Access-Token: your-api-key
    ```
  </Accordion>

  <Accordion icon="code" title="3. Response Structure Changed" defaultOpen>
    All responses now wrapped in standardized format:

    **Before (v2):**

    ```json theme={null}
    {
      "balance": 50000,
      "currency": "DZD"
    }
    ```

    **After (v3):**

    ```json theme={null}
    {
      "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.
  </Accordion>

  <Accordion icon="route" title="4. Endpoint Paths Changed" defaultOpen>
    | v2 Endpoint           | v3 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`   |
  </Accordion>

  <Accordion icon="triangle-exclamation" title="5. Error Handling Changed" defaultOpen>
    **Before (v2):**

    ```json theme={null}
    {
      "error": "Insufficient balance"
    }
    ```

    **After (v3):**

    ```json theme={null}
    {
      "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.
  </Accordion>
</AccordionGroup>

### ✨ 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

<Warning>
  **v2 will be deprecated on October 30, 2026**. Migrate before this date to avoid service disruption.
</Warning>

### 🔗 Resources

* [Complete Migration Guide](/en/migration-from-v2)
* [v3 API Reference](/en/api-reference/response-format)
* [Authentication Guide](/en/authentication)

***

## 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?

<Card title="Contact Support" icon="headset" href="/en/contact">
  Questions about migration? We're here to help.
</Card>