التحقق من الحالة بالمرجع

{
  "success": true,
  "data": {
    "_id": "6901616fe9e88196b4eb64b0",
    "ref": "order-001",
    "status": "SUCCESS",
    "MSSIDN": "0776543210",
    "operator": "Djezzy",
    "planCode": "PREPAID_DJEZZY",
    "planName": "📱 PREPAID | عادي",
    "amount": 500,
    "cost": 496.25,
    "createdAt": "2025-10-29T00:35:59.454Z",
    "updatedAt": "2025-10-29T00:36:05.123Z"
  }
}

async function pollTopUpStatus(ref, maxAttempts = 12, intervalMs = 5000) {
  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
    const response = await fetch(
      `https://api.oneclickdz.com/v3/mobile/topup/ref/${encodeURIComponent(ref)}`,
      {
        headers: { "X-Access-Token": API_KEY },
      }
    );

    const data = await response.json();

    if (!data.success) {
      throw new Error(`Failed to check status: ${data.error.message}`);
    }

    const { status } = data.data;

    if (status === "SUCCESS") {
      return { success: true, data: data.data };
    }

    if (status === "FAILED") {
      return { success: false, data: data.data };
    }

    if (status === "UNKNOWN_ERROR") {
      // Stop polling - schedule a check after 24h, do NOT refund
      return { success: null, data: data.data, requiresManualReview: true };
    }

    // Still PENDING - wait and retry
    if (attempt < maxAttempts) {
      await new Promise((resolve) => setTimeout(resolve, intervalMs));
    }
  }

  // Timeout - treat as UNKNOWN_ERROR
  return { success: null, timedOut: true, requiresManualReview: true };
}

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Top-up with reference 'order-12345' not found"
  },
  "requestId": "req_1730160975_abc123"
}