Passer au contenu principal
GET
/
v3
/
internet
/
check-id
/
{id}
Vérifier le Statut par ID
curl --request GET \
  --url https://api.oneclickdz.com/v3/internet/check-id/{id} \
  --header 'X-Access-Token: <api-key>'
{
  "status": "<string>",
  "card_code": "<string>",
  "num_trans": "<string>",
  "date_traitement": "<string>"
}

​
Vue d’ensemble

Suivez le statut d’une recharge internet et récupérez les détails de la carte lorsqu’elle est livrée.

​
Paramètres de chemin

​
id
string
requis
ID interne de la recharge provenant de la réponse /internet/send

​
Champs de réponse

​
status
string
  • HANDLING : En cours de traitement (3 à 45s) - FULFILLED : Terminé avec le code carte ✅
  • REFUNDED : Échoué et remboursé ❌ - QUEUED : Programmé (12 à 48h) ⏰
​
card_code
string
Code de carte activé (disponible lorsque FULFILLED)
​
num_trans
string
Numéro de transaction Algérie Télécom
​
date_traitement
string
Date de traitement

​
Exemples

curl https://api.oneclickdz.com/v3/internet/check-id/6901616fe9e88196b4eb64b2 \
  -H "X-Access-Token: YOUR_API_KEY"

​
Réponse lorsque livré

{
  "success": true,
  "data": {
    "_id": "6901616fe9e88196b4eb64b2",
    "ref": "internet-order-001",
    "status": "FULFILLED",
    "type": "ADSL",
    "number": "036362608",
    "topup_amount": 1000,
    "card_code": "123456789012",
    "num_trans": "AT-2025-12345",
    "date_traitement": "2025-10-29T01:05:30.000Z",
    "created_at": "2025-10-29T01:00:00.000Z"
  }
}

​
Exemple d’interrogation

async function pollInternetStatus(topupId) {
  const maxAttempts = 60;

  for (let i = 0; i < maxAttempts; i++) {
    const response = await fetch(
      `https://api.oneclickdz.com/v3/internet/check-id/${topupId}`,
      { headers: { "X-Access-Token": process.env.API_KEY } }
    );

    const { data } = await response.json();

    if (["FULFILLED", "REFUNDED", "QUEUED"].includes(data.status)) {
      return data;
    }

    await new Promise((resolve) => setTimeout(resolve, 5000));
  }

  throw new Error("Timeout");
}

​
Gestion du statut QUEUED

QUEUED signifie que la recharge est programmée pour plus tard (12 à 48 heures). Ne la traitez pas comme un échec.
if (status === "QUEUED") {
  // Save for later verification
  await db.orders.update({
    id: orderId,
    status: "SCHEDULED",
    message: "Card will be delivered within 48 hours",
  });

  // Check again after 24h
  scheduleRecheck(orderId, 24 * 60 * 60 * 1000);
}

​
Liens utiles

Vérifier par Référence

Suivre avec une référence personnalisée

Envoyer une Recharge

Créer une nouvelle commande