API Documentation

Auto Syria API

واجهة بسيطة للتحقق من تحويلات شام كاش من موقعك باستخدام توكن حسابك في Auto Syria.

POST

Base URL

https://autosyria.mg1media.com/merchant-api.php

كل الطلبات ترسل JSON وتستخدم Bearer Token في الهيدر.

AUTH

Authorization

Authorization: Bearer YOUR_API_TOKEN

التوكن يظهر من صفحة إعدادات API داخل حساب العميل.

Endpoint

التحقق من عملية تحويل

POST

يرجع verified: true عندما يجد رقم العملية والمبلغ داخل معاملات حساب شام كاش المرتبط بصاحب التوكن.

Body

{
  "account_id": "ACCOUNT_ID",
  "transaction_id": "OPERATION_ID",
  "amount": "1000"
}

cURL

curl -X POST https://autosyria.mg1media.com/merchant-api.php \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"account_id":"ACCOUNT_ID","transaction_id":"OPERATION_ID","amount":"1000"}'

PHP

$payload = json_encode([
    'account_id' => 'ACCOUNT_ID',
    'transaction_id' => 'OPERATION_ID',
    'amount' => '1000',
]);

$ch = curl_init('https://autosyria.mg1media.com/merchant-api.php');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_TOKEN',
        'Content-Type: application/json',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);

if (($result['verified'] ?? false) === true) {
    // Add balance to your customer.
}

Success Response

{
  "success": true,
  "verified": true,
  "account_id": "ACCOUNT_ID",
  "transaction": {
    "id": "OPERATION_ID",
    "amount": "1000"
  },
  "checked_at": "2026-09-22 14:30:00"
}

Error Response

{
  "success": false,
  "message": "Unauthorized."
}

ملاحظات مهمة

  • لا تضع التوكن داخل JavaScript في المتصفح. استخدمه من السيرفر الخاص بموقعك فقط.
  • التوكن يقرأ حسابات شام كاش المرتبطة بحساب Auto Syria الخاص به فقط.
  • إذا غيّرت التوكن من صفحة الإعدادات، أي تكامل يستخدم التوكن القديم سيتوقف فورًا.
  • لو جلسة شام كاش انتهت عند المصدر، سيحتاج العميل إلى إعادة ربط الحساب.