// 1. عبر الترويسة Header (مُفضّل وموصى به):
X-Api-Key: YOUR_API_KEY_HERE

// 2. أو عبر Bearer Token:
Authorization: Bearer YOUR_API_KEY_HERE

// 3. أو عبر رابط الطلب Query String:
https://apisham.com/api/v1?resource=status&api_key=YOUR_API_KEY_HERE

// طلب cURL:
curl -X GET "https://apisham.com/api/v1?resource=status" \
  -H "X-Api-Key: YOUR_API_KEY_HERE"

// الاستجابة (200 OK):
{
  "success": true,
  "message": "API is working.",
  "user": {
    "id": 1,
    "name": "مدير النظام",
    "email": "[email protected]"
  },
  "limits": {
    "max_linked_accounts": 10,
    "active_accounts": 2
  }
}

{
  "success": true,
  "data": {
    "syriatel": [],
    "shamcash": [
      {
        "account_address": "98687efc8a61959fff248221f01cade0",
        "name": "حمود محمد الحسن العمر",
        "phone": "0938706210",
        "account_number": "7042734259852681",
        "status": "active"
      }
    ]
  }
}

{
  "success": true,
  "data": {
    "account_address": "98687efc8a61959fff248221f01cade0",
    "balances": [
      { "currency": "USD", "balance": 55.95 },
      { "currency": "SYP", "balance": 0 },
      { "currency": "EUR", "balance": 0 }
    ]
  }
}

// عند العثور على العملية (وجد الدفع):
{
  "success": true,
  "data": {
    "found": true,
    "transaction": {
      "tran_id": "587150890",
      "from_name": "عبد الرحمن وحيد عصفور",
      "to_name": "حمود محمد الحسن العمر",
      "currency": "USD",
      "amount": 20,
      "datetime": "2026-11-11 02:02:00",
      "account": "6860************",
      "note": ""
    },
    "account": {
      "account_address": "98687efc8a61959fff248221f01cade0"
    }
  }
}

// عند عدم العثور على العملية (رقم غير صحيح أو لم يصل):
{
  "success": true,
  "data": {
    "found": false,
    "tran_id": "987654321"
  }
}

<?php
function verify_shamcash_payment($tran_id, $expected_amount, $expected_currency = 'USD') {
    $api_url = "https://apisham.com/api/v1?resource=shamcash&action=find_tx&tx=" . urlencode($tran_id);
    $api_key = "YOUR_API_KEY_HERE";

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $api_url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "X-Api-Key: " . $api_key,
        "Accept: application/json"
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    $json = json_decode($response, true);
    if ($json && isset($json['success']) && $json['success'] && isset($json['data']['found']) && $json['data']['found']) {
        $tx = $json['data']['transaction'];
        if ($tx['amount'] >= $expected_amount && strtoupper($tx['currency']) === strtoupper($expected_currency)) {
            return [
                'status' => true,
                'sender' => $tx['from_name'],
                'amount' => $tx['amount'],
                'time'   => $tx['datetime']
            ];
        }
    }
    return ['status' => false, 'error' => 'العملية غير موجودة أو المبلغ غير مطابق'];
}
?>

{
  "success": true,
  "data": {
    "account_address": "98687efc8a61959fff248221f01cade0",
    "items": [
      {
        "tran_id": "587150890",
        "from_name": "عبد الرحمن وحيد عصفور",
        "to_name": "حمود محمد الحسن العمر",
        "currency": "USD",
        "amount": 20,
        "datetime": "2026-11-11 02:02:00",
        "account": "6860************",
        "note": ""
      }
    ]
  }
}

curl -X POST "https://apisham.com/api/v1?resource=shamcash&action=transfer" \
  -H "X-Api-Key: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "account_address=YOUR_ACCOUNT_ADDRESS" \
  -d "receive_key=TARGET_ACCOUNT_ADDRESS" \
  -d "amount=10" \
  -d "currency=USD" \
  -d "note=دفعة فاتورة"

// الاستجابة:
{
  "success": true,
  "data": {
    "message": "تم تحويل مبلغ 10 USD بنجاح ✅",
    "source_account": { "account_address": "YOUR_ACCOUNT_ADDRESS" },
    "recipient": { "address": "TARGET_ACCOUNT_ADDRESS" },
    "transfer": { "amount": "10", "currency": "USD", "note": "دفعة فاتورة" }
  }
}