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

# Introduction

> Complete telecom services API for Algeria - Mobile top-ups, Internet recharge, and Gift cards

## OneClickDz Flexy API v3

OneClick is the official distributor of Algérie Télécom and Djezzy, and the only digital platform in Algeria that provides telecom recharges, internet cards, and international digital vouchers (PlayStation, Steam, Xbox, etc.) under one brand.
Our API allows businesses to easily integrate these services directly into their websites, apps, or POS systems - with instant delivery and secure payments.

**Built for developers** with standardized responses, comprehensive error handling, and detailed documentation.

## Quick Navigation

<CardGroup cols={2}>
  <Card title="Quickstart Guide" icon="rocket" href="/en/quickstart">
    Get up and running in 5 minutes
  </Card>

  <Card title="Mobile Top-Ups" icon="mobile" href="/en/mobile-topup-guides/overview">
    Complete mobile recharge workflow
  </Card>

  <Card title="Internet Top-Ups" icon="wifi" href="/en/internet-topup-guides/overview">
    ADSL and 4G recharge guide
  </Card>

  <Card title="Gift Cards" icon="gift" href="/en/gift-card-guides/overview">
    Digital product delivery workflow
  </Card>

  <Card title="Navio" icon="credit-card" href="/en/ocpay-guides/overview">
    Payment gateway integration
  </Card>
</CardGroup>

## Our Services

### Mobile Top-Ups

Send instant top-ups to all Algerian mobile operators with real-time status tracking.

**Supported Operators:**

* Mobilis (Prepaid, Postpaid, Fixed)
* Djezzy (Prepaid, Postpaid, Fixed)
* Ooredoo (Prepaid, Postpaid, Fixed)

**Features:**

* Dynamic and fixed-amount plans
* Instant or scheduled top-ups
* Automatic refunds on failure
* Status tracking with unique references

[View Mobile API Reference →](/en/api-reference/mobile/list-plans)

### Internet Top-Ups

Recharge ADSL and 4G LTE internet lines instantly with phone number validation.

**Services:**

* ADSL recharge
* 4G LTE recharge
* Multiple card denominations
* Real-time stock availability

**Features:**

* Phone number validation before purchase
* Instant recharge with just the phone number
* Transaction tracking

[View Internet API Reference →](/en/api-reference/internet/list-products)

### Gift Cards & Digital Products

Deliver digital gift cards and vouchers instantly with comprehensive product catalog.

**Categories:**

* Gaming cards (Freefire, Pubg, PSN, Xbox, Steam ..)
* Streaming services (Shahid ..)
* Digital wallets (iTunes, Amazon ..)
* Mobile recharge cards
* And more...

**Features:**

* 100+ products available
* Real-time stock checking
* Instant digital delivery
* Bulk order support

[View Gift Cards API Reference →](/en/api-reference/gift-cards/get-catalog)

### Navio - Payment Gateway

Accept online payments from your customers with our integrated payment gateway solution.

**Payment Methods:**

* CIB (Credit cards)
* eDahabia (National debit card)

**Features:**

* Simple payment link creation
* Multiple payment methods in one integration
* Real-time payment status tracking
* Automatic payment verification
* Secure transaction handling
* Custom amount support

**Use Cases:**

* E-commerce checkout integration
* Service subscription payments
* Invoice payment collection
* Donation and fundraising
* Event ticket sales

[View Navio API Reference →](/en/api-reference/ocpay/create-link)

## Why Choose Our API?

<CardGroup cols={2}>
  <Card title="Standardized Responses" icon="code">
    Consistent JSON structure across all endpoints with `success`, `data`,
    `meta`, and `requestId` fields
  </Card>

  <Card title="Comprehensive Error Handling" icon="shield-check">
    Clear error codes, detailed messages, and actionable guidance for every
    scenario
  </Card>

  <Card title="Request Tracking" icon="fingerprint">
    Unique `requestId` for every request enables easy debugging and support
  </Card>

  <Card title="Type Safety" icon="lock">
    Full schema validation prevents invalid requests and ensures data integrity
  </Card>

  <Card title="Sandbox Testing" icon="flask">
    Test all features without affecting balance using sandbox mode
  </Card>

  <Card title="Interactive Documentation" icon="book-open">
    Try API calls directly in documentation with built-in playground
  </Card>
</CardGroup>

## Pricing & Business Model

### Simple Pay-As-You-Go

* **No integration fees** - Start building for free
* **No monthly subscriptions** - Pay only for what you use
* **No hidden charges** - Only pay for successful transactions
* **Automatic refunds** - Failed transactions are refunded instantly

### How Billing Works

1. **Prepaid Balance**: Maintain a balance in your OneClickDz account
2. **Automatic Deduction**: Successful transactions deduct from your balance
3. **Transparent Pricing**: All prices in Algerian Dinar (DZD)

### Business Discounts

We offer **the best discounts for businesses** who want to resell our services to final clients. Our competitive pricing structure is designed to help you build profitable telecom service businesses.

<Card title="Inquire About Business Pricing" icon="handshake" href="/en/contact">
  Contact us to discuss volume discounts and business partnerships
</Card>

## Getting Started

Ready to integrate? Follow these simple steps:

<Steps>
  <Step title="Create Account">
    Sign up at [oneclickdz.com](https://enterprise.oneclickdz.com) to access your
    dashboard
  </Step>

  <Step title="Generate API Key">
    Enable API access in [settings](https://enterprise.oneclickdz.com/api-keys) and
    generate your keys (sandbox + production)
  </Step>

  <Step title="Test in Sandbox">
    Use sandbox mode to test all features without affecting your balance
  </Step>

  <Step title="Go Live">
    Switch to production key when ready to process real transactions
  </Step>
</Steps>

[Get Started with Quickstart →](/en/quickstart)

## API Response Format

All v3 endpoints return consistent, predictable responses:

<CodeGroup>
  ```json Success Response theme={null}
  {
    "success": true,
    "data": {
      "balance": 50000
    },
    "meta": {
      "timestamp": "2025-10-29T00:00:00.000Z"
    },
    "requestId": "req_1234567890_abc123"
  }
  ```

  ```json Error Response theme={null}
  {
    "success": false,
    "error": {
      "code": "INSUFFICIENT_BALANCE",
      "message": "Your balance is insufficient for this operation",
      "details": {
        "required": 1000,
        "available": 500
      }
    },
    "requestId": "req_1234567890_abc123"
  }
  ```
</CodeGroup>

[Learn more about Response Format →](/en/api-reference/response-format)

## Use Cases

<AccordionGroup>
  <Accordion icon="store" title="E-commerce Platforms">
    Integrate telecom services into your marketplace. Let customers buy mobile top-ups, internet recharge, and gift cards alongside your products.
  </Accordion>

  {" "}

  <Accordion icon="mobile-screen" title="Mobile Apps">
    Build mobile recharge apps for iOS and Android. Offer multi-operator top-ups
    with real-time tracking and instant delivery.
  </Accordion>

  {" "}

  <Accordion icon="building" title="Point of Sale Systems">
    Add digital services to your POS. Sell mobile credit, internet cards, and gift
    cards at your retail locations.
  </Accordion>

  {" "}

  <Accordion icon="users" title="Multi-Level Marketing">
    Create reseller networks with commission systems. Track transactions, manage
    balances, and distribute profits automatically.
  </Accordion>

  {" "}

  <Accordion icon="chart-line" title="Financial Services">
    Integrate telecom services into banking apps, payment platforms, and digital
    wallets for comprehensive financial solutions.
  </Accordion>

  <Accordion icon="headset" title="Customer Service">
    Build support tools for helpdesk teams to quickly assist customers with top-ups and recharges during support calls.
  </Accordion>
</AccordionGroup>

## Developer Resources

<CardGroup cols={3}>
  <Card title="API Reference" icon="code" href="/en/api-reference/response-format">
    Complete endpoint documentation
  </Card>

  <Card title="Authentication" icon="key" href="/en/authentication">
    Secure your API access
  </Card>

  <Card title="Error Handling" icon="triangle-exclamation" href="/en/api-reference/error-handling">
    Handle errors like a pro
  </Card>

  <Card title="Polling Strategies" icon="rotate" href="/en/polling-strategies">
    Optimize status checking
  </Card>

  <Card title="Webhooks" icon="webhook" href="/en/webhooks">
    Real-time notifications
  </Card>

  <Card title="Best Practices" icon="lightbulb" href="/en/security-best-practices">
    Production-ready patterns
  </Card>
</CardGroup>

## Need Help?

<CardGroup cols={2}>
  <Card title="Email Support" icon="envelope" href="mailto:support@oneclickdz.com">
    Reach our support team at [support@oneclickdz.com](mailto:support@oneclickdz.com)
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/oneclickdz">
    Browse code examples and SDKs
  </Card>
</CardGroup>

***

<Note>
  **Ready to start?** Head over to the [Quickstart Guide](/en/quickstart) to send
  your first top-up in under 5 minutes.
</Note>