GetDataGH API

const API_KEY = process.env.GDGH_API_KEY;
const BASE = "https://www.getdatagh.com/api/v1";

const headers = {
  Authorization: `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};

// ── List all MTN packages ──────────────────────
async function listPackages(network) {
  const url = new URL(`${BASE}/packages`);
  if (network) url.searchParams.set("network", network);

  const res = await fetch(url, { headers });
  if (!res.ok) throw new Error(`Failed to list packages: ${res.status}`);

  return res.json();
}

// ── Initiate a purchase ────────────────────────
async function purchase({ packageCode, phoneNumber, network, email, callbackUrl }) {
  const res = await fetch(`${BASE}/purchase`, {
    method: "POST",
    headers,
    body: JSON.stringify({
      package_code: packageCode,
      phone_number: phoneNumber,
      network,
      email,
      callback_url: callbackUrl,
    }),
  });

  if (!res.ok) {
    const { error } = await res.json();
    throw new Error(`Purchase failed [${error.code}]: ${error.message}`);
  }

  return res.json();
}

// ── Check transaction status ───────────────────
async function getTransaction(ref) {
  const res = await fetch(`${BASE}/transactions/${ref}`, { headers });
  if (!res.ok) throw new Error(`Transaction not found: ${ref}`);

  return res.json();
}

// ── Check balance ──────────────────────────────
async function getBalance() {
  const res = await fetch(`${BASE}/balance`, { headers });
  if (!res.ok) throw new Error("Failed to fetch balance");

  return res.json();
}

// ── Usage ──────────────────────────────────────
async function main() {
  // 1. List MTN packages
  const { packages } = await listPackages("MTN");
  console.log("Available packages:", packages);

  // 2. Purchase first package
  const result = await purchase({
    packageCode: packages[0].package_code,
    phoneNumber: "0241234567",
    network: "MTN",
    email: "customer@example.com",
    callbackUrl: "https://yoursite.com/success",
  });
  console.log("Payment URL:", result.payment_url);

  // 3. Check status (after customer pays)
  const tx = await getTransaction(result.transaction_ref);
  console.log("Status:", tx.status, "| Delivery:", tx.data_transfer_status);

  // 4. Check balance
  const balance = await getBalance();
  console.log("Pending payout:", balance.pending_payout, "GHS");
}

main().catch(console.error);

import os
import requests

API_KEY = os.environ["GDGH_API_KEY"]
BASE = "https://www.getdatagh.com/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}


def list_packages(network: str | None = None) -> dict:
    """List available data packages, optionally filtered by network."""
    params = {"network": network} if network else {}
    response = requests.get(f"{BASE}/packages", headers=HEADERS, params=params)
    response.raise_for_status()
    return response.json()


def purchase(
    package_code: str,
    phone_number: str,
    network: str,
    email: str | None = None,
    callback_url: str | None = None,
) -> dict:
    """Initiate a data bundle purchase."""
    payload = {
        "package_code": package_code,
        "phone_number": phone_number,
        "network": network,
    }
    if email:
        payload["email"] = email
    if callback_url:
        payload["callback_url"] = callback_url

    response = requests.post(f"{BASE}/purchase", headers=HEADERS, json=payload)
    response.raise_for_status()
    return response.json()


def get_transaction(ref: str) -> dict:
    """Check the status of a transaction."""
    response = requests.get(f"{BASE}/transactions/{ref}", headers=HEADERS)
    response.raise_for_status()
    return response.json()


def get_balance() -> dict:
    """Get your commission balance summary."""
    response = requests.get(f"{BASE}/balance", headers=HEADERS)
    response.raise_for_status()
    return response.json()


# ── Usage ──────────────────────────────────────────
if __name__ == "__main__":
    # 1. List MTN packages
    data = list_packages("MTN")
    print(f"Found {len(data['packages'])} MTN packages")

    # 2. Initiate a purchase
    result = purchase(
        package_code="MTN-1GB",
        phone_number="0241234567",
        network="MTN",
        email="customer@example.com",
        callback_url="https://yoursite.com/success",
    )
    print(f"Payment URL: {result['payment_url']}")

    # 3. Check transaction status
    tx = get_transaction(result["transaction_ref"])
    print(f"Status: {tx['status']} | Delivery: {tx['data_transfer_status']}")

    # 4. Check balance
    balance = get_balance()
    print(f"Pending payout: GHS {balance['pending_payout']}")

<?php

class GetDataGH
{
    private string $apiKey;
    private string $baseUrl = "https://www.getdatagh.com/api/v1";

    public function __construct(string $apiKey)
    {
        $this->apiKey = $apiKey;
    }

    /**
     * List available data packages.
     */
    public function listPackages(?string $network = null): array
    {
        $url = $this->baseUrl . "/packages";
        if ($network) {
            $url .= "?network=" . urlencode($network);
        }

        return $this->request("GET", $url);
    }

    /**
     * Initiate a data bundle purchase.
     */
    public function purchase(array $data): array
    {
        return $this->request("POST", $this->baseUrl . "/purchase", $data);
    }

    /**
     * Check transaction status by reference.
     */
    public function getTransaction(string $ref): array
    {
        return $this->request("GET", $this->baseUrl . "/transactions/" . $ref);
    }

    /**
     * Get your commission balance summary.
     */
    public function getBalance(): array
    {
        return $this->request("GET", $this->baseUrl . "/balance");
    }

    private function request(string $method, string $url, ?array $body = null): array
    {
        $ch = curl_init($url);
        $headers = [
            "Authorization: Bearer " . $this->apiKey,
            "Content-Type: application/json",
        ];

        curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

        if ($method === "POST" && $body) {
            curl_setopt($ch, CURLOPT_POST, true);
            curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
        }

        $response = curl_exec($ch);
        $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        $data = json_decode($response, true);

        if ($statusCode >= 400) {
            throw new Exception(
                "API Error [{$data['error']['code']}]: {$data['error']['message']}"
            );
        }

        return $data;
    }
}

// ── Usage ──────────────────────────────────────────
$api = new GetDataGH(getenv("GDGH_API_KEY"));

// 1. List MTN packages
$packages = $api->listPackages("MTN");
echo "Found " . count($packages["packages"]) . " MTN packages\n";

// 2. Initiate a purchase
$result = $api->purchase([
    "package_code" => "MTN-1GB",
    "phone_number" => "0241234567",
    "network" => "MTN",
    "email" => "customer@example.com",
    "callback_url" => "https://yoursite.com/success",
]);
echo "Payment URL: " . $result["payment_url"] . "\n";

// 3. Redirect customer to payment
header("Location: " . $result["payment_url"]);

# Set your API key
export GDGH_KEY="gdgh_your_api_key_here"

# ── List all packages ──────────────────────────
curl -s -H "Authorization: Bearer $GDGH_KEY" \
  "https://www.getdatagh.com/api/v1/packages" | jq .

# ── List MTN packages only ─────────────────────
curl -s -H "Authorization: Bearer $GDGH_KEY" \
  "https://www.getdatagh.com/api/v1/packages?network=MTN" | jq .

# ── Initiate a purchase ───────────────────────
curl -s -X POST "https://www.getdatagh.com/api/v1/purchase" \
  -H "Authorization: Bearer $GDGH_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "package_code": "MTN-1GB",
    "phone_number": "0241234567",
    "network": "MTN",
    "email": "customer@example.com",
    "callback_url": "https://yoursite.com/success"
  }' | jq .

# ── Check a transaction ───────────────────────
curl -s -H "Authorization: Bearer $GDGH_KEY" \
  "https://www.getdatagh.com/api/v1/transactions/GD8A3F1B2C" | jq .

# ── Check your balance ────────────────────────
curl -s -H "Authorization: Bearer $GDGH_KEY" \
  "https://www.getdatagh.com/api/v1/balance" | jq .