مكوّن العنوان للمتاجر الإلكترونية

بدل أن يكتب العميل عنواناً سورياً طويلاً في كل طلب، يكتب رمز سيرياسان مرة واحدة — يُحل العنوان ويؤكده العميل، ويصل المتجر إلى إحداثيات المدخل مباشرة. لا تُكشف بيانات الشقة الخاصة إلا إذا شاركها صاحب العنوان عبر رابط مؤقت.

العنوان الذكي

بدلاً من كتابة العنوان بالكامل، أدخل الرمز الذكي أو رابط المشاركة المؤقت.

تضمين في أي متجر (HTML + JS)

<!-- 1. ضع الإطار في صفحة الدفع -->
<iframe
  id="syriasan-address"
  src="https://syriasan.com/embed/address"
  style="width:100%;height:520px;border:0"
  title="Syriasan address"
></iframe>

<script>
  window.addEventListener('message', function (event) {
    if (event.origin !== 'https://syriasan.com') return;
    if (event.data && event.data.type === 'syriasan:address') {
      var a = event.data.payload;
      document.querySelector('[name="billing_address_1"]').value = a.summary;
      document.querySelector('[name="syriasan_code"]').value = a.reference;
      document.querySelector('[name="syriasan_lat"]').value = a.coordinates ? a.coordinates.latitude : '';
      document.querySelector('[name="syriasan_lng"]').value = a.coordinates ? a.coordinates.longitude : '';
    }
  });
</script>

React / Next.js

import { SyriasanAddressField } from "@/components/SyriasanAddressField";

<SyriasanAddressField
  apiBase="https://syriasan.com"
  onConfirm={(address) => {
    setOrderAddress({
      code: address.reference,
      line: address.summary,
      lat: address.coordinates?.latitude,
      lng: address.coordinates?.longitude,
      navigation: address.navigation_url,
    });
  }}
/>

واجهة REST العامة

GET https://syriasan.com/api/public/checkout?reference=SY-DAM-K7X4

{
  "status": "ok",
  "source": "code",
  "reference": "SY-DAM-K7X4",
  "summary": "دمشق — المزة — شارع الجلاء — بناء 12 — المدخل الرئيسي",
  "fields": {
    "governorate": "دمشق", "city": "دمشق", "district": null,
    "neighborhood": "المزة", "street": "شارع الجلاء",
    "building": "12", "entrance": "المدخل الرئيسي",
    "floor": null, "unit": null, "landmark": "مقابل الحديقة"
  },
  "coordinates": { "latitude": 33.51, "longitude": 36.278 },
  "delivery": { "instructions": "…", "parking": "…", "open_now": true },
  "verification_level": "business_verified",
  "navigation_url": "https://syriasan.com/d/SY-DAM-K7X4",
  "privacy_note": "عنوان عام — لا تُعرض أي بيانات سكنية خاصة."
}

WooCommerce

// functions.php — WooCommerce
add_action('woocommerce_before_checkout_billing_form', function () {
  echo '<iframe src="https://syriasan.com/embed/address" style="width:100%;height:520px;border:0"></iframe>';
  echo '<input type="hidden" name="syriasan_code" id="syriasan_code" />';
});

add_action('woocommerce_checkout_create_order', function ($order) {
  if (!empty($_POST['syriasan_code'])) {
    $order->update_meta_data('syriasan_code', sanitize_text_field($_POST['syriasan_code']));
  }
});

Shopify

{% comment %} Shopify — checkout / cart page block {% endcomment %}
<iframe src="https://syriasan.com/embed/address" style="width:100%;height:520px;border:0"></iframe>
<script>
  window.addEventListener('message', function (e) {
    if (e.origin !== 'https://syriasan.com') return;
    if (e.data.type !== 'syriasan:address') return;
    fetch('/cart/update.js', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ attributes: {
        syriasan_code: e.data.payload.reference,
        syriasan_address: e.data.payload.summary
      } })
    });
  });
</script>

قواعد الخصوصية في الدفع

• الرموز العامة تعيد بيانات عامة فقط (محافظة، حي، شارع، بناء، مدخل).
• العناوين السكنية الخاصة لا تُحل عبر الرمز — تُستخدم روابط مؤقتة SY-TMP-….
• الرابط المؤقت يكشف فقط الحقول التي وافق صاحب العنوان على مشاركتها، وينتهي تلقائياً.
• لا يُسلَّم أي عنوان للمتجر قبل أن يضغط العميل «تأكيد هذا العنوان».