Passer au contenu principal

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

Intégrez la vente de cartes de recharge internet ADSL et 4G LTE en 5 étapes simples. Cette vue d’ensemble explique le flux de travail-l’implémentation détaillée avec des exemples de code se trouve dans les guides étape par étape ci-dessous.
Les cartes internet sont livrées numériquement avec des codes et des numéros de transaction une fois exécutées.

​
Comment ça fonctionne

​
Processus d’intégration en 5 étapes

1

Charger les produits

Obtenez les cartes ADSL et 4G disponibles avec les tarifs et le statut du stock.→ Voir Étape 1 : Chargement des produits
2

Valider le numéro

Vérifiez le format du numéro de téléphone (ADSL : 9 chiffres, 4G : 12 chiffres) avant de commander.→ Voir Étape 2 : Validation
3

Envoyer la recharge

Soumettez la commande avec le type de service, le numéro et la valeur de la carte.→ Voir Étape 3 : Envoi des recharges
4

Suivre le statut

Interrogez le statut de la commande toutes les 5 à 10 secondes jusqu’à FULFILLED, QUEUED ou REFUNDED.→ Voir Étape 4 : Suivi du statut
5

Livrer la carte

Récupérez et livrez en toute sécurité le code de carte et le numéro de transaction.→ Voir Étape 5 : Livraison de la carte

​
Ce que vous devez savoir

​
Types de service

  • ADSL : Internet fixe (numéros à 9 chiffres commençant par 0)
  • 4G LTE : Internet mobile (numéros à 12 chiffres commençant par 213)
→ Formats de numéros à l’Étape 2

​
Statut de commande

  • HANDLING → Continuez à interroger (3 à 45 secondes)
  • FULFILLED → Carte prête ! Récupérez card_code et num_trans ✅
  • QUEUED → Livraison programmée (12 à 48 heures) ⏰
  • REFUNDED → Échec, remboursement émis ❌
→ Gestion des statuts à l’Étape 4

​
Commandes QUEUED

QUEUED n’est pas un échec ! Cela signifie que la carte sera livrée dans les 12 à 48 heures. Enregistrez la commande et revérifiez plus tard. → Gestion de QUEUED à l’Étape 4

​
Tarification

Appliquez votre marge sur les prix de gros avant d’afficher aux clients. Exemple : 980 DA en gros → Vendez à 1029 DA (5% de marge) → Profit : 49 DA → Tarification à l’Étape 1

​
Points clés

Toujours valider

Utilisez /check-number avant de soumettre des commandes→ Étape 2

Vérifier le stock

Vérifiez available: true avant d’afficher les cartes→ Étape 1

Gérer QUEUED

Ne traitez pas QUEUED comme un échec-planifiez des revérifications→ Étape 4

Livraison sécurisée

Chiffrez les codes de carte en stockage et en transmission→ Étape 5

​
Référence API

Lister les produits

GET /v3/internet/products

Valider le numéro

GET /v3/internet/check-number

Envoyer la recharge

POST /v3/internet/send

Vérifier le statut

GET /v3/internet/check-id/:id

​
Tests

Utilisez le mode sandbox pour tester sans transactions réelles. Tous les numéros de téléphone fonctionnent en sandbox et les commandes s’exécutent instantanément avec des codes de carte de test. Activez le sandbox dans les paramètres du tableau de bord.

​
Commencer l’intégration

Commencer avec l'Étape 1 : Chargement des produits

Commencez par charger les cartes disponibles avec des exemples de code

​
Ressources supplémentaires

Guide de démarrage rapide

Démarrez en 5 minutes

Authentification

Apprenez à authentifier les requêtes

Meilleures pratiques de sécurité

Sécurisez votre intégration

Contacter le support

Obtenez l’aide de notre équipe