واجهة برمجة تطبيقات الجهاز (Device API)

registerDevice

POST https://api.pushwoosh.com/json/1.3/registerDevice

يتم استدعاؤها داخليًا من SDK. تسجل الجهاز للتطبيق.

رؤوس الطلب

الاسم	مطلوب	القيمة	الوصف
Authorization	نعم	Token `XXXX`	رمز جهاز API للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل `XXXX` برمز جهاز API الفعلي الخاص بك.

جسم الطلب

الاسم	النوع	الوصف
application*	string	رمز تطبيق Pushwoosh
push_token	string	رمز الدفع (Push token) للجهاز.
language	string	لغة الجهاز المحلية. يجب أن يكون رمزًا من حرفين صغيرين وفقًا لمعيار ISO-639-1.
hwid*	string	سلسلة فريدة لتعريف الجهاز (IDFV على iOS، قيمة يتم إنشاؤها عشوائيًا على Android). اعرف المزيد
timezone	integer	إزاحة المنطقة الزمنية بالثواني للجهاز.
device_type*	integer	نوع الجهاز. انظر القيم الممكنة أدناه.
email	string	عنوان البريد الإلكتروني للتسجيل (يستخدم لمستخدمي البريد الإلكتروني بدلاً من HWID و push token).
tags	object	قيم العلامات لتعيينها للجهاز المسجل.

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

{
  "request": {
    "application": "XXXXX-XXXXX",        // مطلوب. رمز تطبيق Pushwoosh
    "push_token": "dec301908b9ba8XXXXX57a58e40f96f5XXXXX2068674f5XXXXa25cdc250a2a41", // اختياري.
    "hwid": "1CA6XXXXX-8DAC-XXXXX-XXXXX-B756288B6D3C",                                   // مطلوب. معرف جهاز الجهاز (Hardware ID)
    "idfa": "AEBE52E7-0XXXXX-455A-XXXXX-E57283966239",                                   // اختياري.
    "timezone": 3600,                    // اختياري. الإزاحة بالثواني
    "device_type": 1,                    // مطلوب. انظر القيم الممكنة أدناه. بالنسبة للبريد الإلكتروني،
                                         //           استخدم معلمات "emails" كما هو موضح أدناه.
    "email": "email_address@domain.com", // استخدم بدلاً من "hwid" و "push_token" لتسجيل
                                         //           عنوان البريد الإلكتروني لمشروع البريد الإلكتروني الخاص بك
    "language": "en",                    // اختياري. رمز اللغة ISO 639-1|639-2
    "userId": "Alex",                    // اختياري.
    "tags": {                            // اختياري. قيم العلامات لتعيينها للجهاز المسجل
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"], // يعين قائمة القيم للعلامات من نوع القائمة
      "DateTag": "2024-10-02 22:11",     // لاحظ أن الوقت يجب أن يكون بتوقيت UTC
      "BooleanTag": true                 // القيم الصالحة هي: true, false
    },

    // علامات النظام، اختيارية
    "app_version": "1.2.3",
    "device_model": "Samsung SM-G355H",
    "os_version": "2.3",

    // مفاتيح تشفير اختيارية لـ chrome/firefox
    "public_key": "BNmDO4BTKEMJqaqprTf7t/HBXXXXX/orcXXXXX/scS5CFP6XXXXXHI1/GgRQD8c4kTxTEEF0quvIUiLQqoBY0/Qo=",
    "auth_token": "RlRmCXXXXX/s7XXXXXjKFzoQ==",

    // مفاتيح FCM اختيارية لـ Chrome (لـ XMPP)
    "fcm_token": "BNmDO4BTKEMJXXXXXprTf7t/XXXXXBQ/orXXXXXc/scS5CFP6zhQGIHI1/GgRQD8c4kTxTEEF0quvIUiLQqoBY0/Qo=",
    "fcm_push_set": "RlXXXXXGM/s7XXXXXjKFzoQ=="
  }
}

أنواع الأجهزة الممكنة:

1 – iOS
3 – Android
7 – Mac OS X
8 – Windows
9 – Amazon
10 – Safari
11 – Chrome
12 – Firefox
14 – Email
17 – Huawei
18 – SMS
21 – WhatsApp

تسجيل أجهزة البريد الإلكتروني

لتسجيل مشترك بريد إلكتروني لتطبيقك، أرسل المعلمة "email": "email_address@domain.com" في طلب /registerDevice أو /registerEmail الخاص بك كما يلي:

مثال على الطلب

{
  "request":{
    "application": "XXXXX-XXXXX",        // مطلوب. رمز تطبيق Pushwoosh
    "email": "email_address@domain.com", // مطلوب. عنوان البريد الإلكتروني للتسجيل في مشروع البريد الإلكتروني الخاص بك
    "language": "en",                    // اختياري. رمز اللغة ISO 639-1|639-2
    "userId": "Alex",                    // اختياري.
    "tags": {                            // اختياري. قيم العلامات لتعيينها للجهاز المسجل
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"], // يعين قائمة القيم للعلامات من نوع القائمة
      "DateTag": "2024-10-02 22:11",     // لاحظ أن الوقت يجب أن يكون بتوقيت UTC
      "BooleanTag": true                 // القيم الصالحة هي: true, false
    }
  }
}

تسجيل أجهزة WhatsApp

لتسجيل جهاز WhatsApp لتطبيقك، اتبع هذه الإرشادات:

hwid: تأكد من أن هذا الحقل يتضمن البادئة whatsapp: متبوعة برقم الهاتف بتنسيق E.164 (على سبيل المثال، whatsapp:+0000000000). يجب أن يكون رقم الهاتف صالحًا، وهو ما سيتحقق منه Pushwoosh.
Push token: لا يلزم وجود رمز دفع (push token)، حيث سيعمل hwid تلقائيًا كرمز دفع.
device_type: اضبط هذا الحقل على 21 لتحديد WhatsApp كمنصة.

مثال على الطلب

{
  "request": {
    "application": "XXXXX-XXXXX",        // مطلوب. رمز تطبيق Pushwoosh
    "hwid": "whatsapp:+0000000000",      // مطلوب. بادئة WhatsApp ورقم هاتف صالح
    "timezone": 3600,                    // اختياري. إزاحة الوقت بالثواني
    "device_type": 21,                   // مطلوب. نوع جهاز WhatsApp هو 21
    "language": "en",                    // اختياري. رمز اللغة ISO 639-1|639-2
    "userId": "Alex",                    // اختياري. معرف المستخدم
    "tags": {                            // اختياري. قيم العلامات للتجزئة المخصصة
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"],
      "DateTag": "2024-10-02 22:11",     // تنسيق UTC
      "BooleanTag": true
    },
    "app_version": "1.2.3",              // اختياري. إصدار التطبيق
    "device_model": "Samsung SM-G355H",  // اختياري. طراز الجهاز
    "os_version": "2.3"                  // اختياري. إصدار نظام التشغيل
  }
}

تسجيل أجهزة الرسائل القصيرة (SMS)

لتسجيل جهاز SMS لتطبيقك، اتبع هذه الإرشادات:

hwid: تأكد من أن هذا الحقل يتضمن رقم الهاتف بتنسيق E.164 (على سبيل المثال، +0000000000). يجب أن يكون رقم الهاتف صالحًا، وهو ما سيتحقق منه Pushwoosh.
Push token: لا يلزم وجود رمز دفع (push token)، حيث سيعمل hwid تلقائيًا كرمز دفع.
device_type: اضبط هذا الحقل المطلوب على 18 لتحديد SMS كمنصة.

مثال على الطلب

{
   "request": {
      "application": "XXXXX-XXXXX",           // مطلوب. رمز تطبيق Pushwoosh
      "hwid": "+0000000000",                  // مطلوب. رقم هاتف صالح بتنسيق E.164
      "timezone": 3600,                       // اختياري. إزاحة الوقت بالثواني
      "device_type": 18,                      // مطلوب. نوع جهاز SMS هو 18
      "language": "en",                       // اختياري. رمز اللغة ISO 639-1|639-2
      "userId": "Alex",                       // اختياري. معرف المستخدم
      "tags": {                               // اختياري. قيم العلامات للتجزئة المخصصة
           "StringTag": "string value",
           "IntegerTag": 42,
           "ListTag": ["string1", "string2"],
           "DateTag": "2024-10-02 22:11",     // تنسيق UTC
           "BooleanTag": true
      },
      "app_version": "1.2.3",                 // اختياري. إصدار التطبيق
      "device_model": "Samsung SM-G355H",     // اختياري. طراز الجهاز
      "os_version": "2.3"                     // اختياري. إصدار نظام التشغيل
   }
}

رموز الحالة:

رمز حالة HTTP	status_code	الوصف
200	200	تم تسجيل الجهاز بنجاح
200	210	خطأ في الوسيط. انظر `status_message` لمزيد من المعلومات.
400	N/A	سلسلة طلب غير صالحة
500	500	خطأ داخلي

unregisterDevice

POST https://api.pushwoosh.com/json/1.3/unregisterDevice

يزيل رمز الدفع (push token) الخاص بالجهاز. لا يزال الجهاز غير المسجل يُحتسب في إجمالي الأجهزة ويمكن الوصول إليه باستخدام In-Apps. يتم استدعاؤها داخليًا من SDK.

رؤوس الطلب

الاسم	مطلوب	القيمة	الوصف
Authorization	نعم	Token `XXXX`	رمز جهاز API للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل `XXXX` برمز جهاز API الفعلي الخاص بك.

جسم الطلب

الاسم	النوع	الوصف
application*	string	رمز تطبيق Pushwoosh
hwid*	string	معرف جهاز الجهاز (Hardware ID) المستخدم في طلب /registerDevice.

{
    "status_code": 200,
    "status_message": "OK",
    "response": null
}

{
  "request": {
    "application": "XXXXX-XXXXX",              // مطلوب. رمز تطبيق Pushwoosh
    "hwid": "8f65b16XXXXXe7a6beceXXXXX530fb2"  // مطلوب. معرف جهاز الجهاز (Hardware ID) المستخدم في واجهة برمجة تطبيقات /registerDevice
  }
}

رموز الحالة:

رمز حالة HTTP	status_code	الوصف
200	200	تم إلغاء اشتراك الجهاز بنجاح
200	210	خطأ في الوسيط. انظر `status_message` لمزيد من المعلومات.
400	N/A	سلسلة طلب غير صالحة
500	500	خطأ داخلي

deleteDevice

POST https://api.pushwoosh.com/api/v2/device-api/deleteDevice

يحذف جهازًا وجميع بياناته المرتبطة به المحددة بواسطة HWID المحدد داخل التطبيق. على عكس /unregisterDevice، الذي يزيل فقط رمز الدفع (push token) ويحتفظ بسجل الجهاز، فإن /deleteDevice يزيل الجهاز بالكامل. تتم معالجة الطلب بشكل غير متزامن، وتعيد نقطة النهاية 200 OK بمجرد قبول طلب الحذف للمعالجة.

رؤوس الطلب

الاسم	مطلوب	القيمة	الوصف
Authorization	نعم	Token `XXXX`	رمز جهاز API للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل `XXXX` برمز جهاز API الفعلي الخاص بك.
Content-Type	نعم	application/json

جسم الطلب

الاسم	مطلوب	النوع	الوصف
application	نعم	string	رمز تطبيق Pushwoosh
hwid	نعم	string	معرف جهاز الجهاز (Hardware ID) للجهاز المراد حذفه.

مثال على الطلب

{
  "application": "XXXXX-XXXXX",                 // مطلوب. رمز تطبيق Pushwoosh
  "hwid": "8f65b16df378e7a6bece9614e1530fb2"    // مطلوب. معرف جهاز الجهاز (Hardware ID) للجهاز المراد حذفه
}

مثال على الاستجابة

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

رموز الحالة

رمز حالة HTTP	status_code	الوصف
200	200	تم قبول طلب الحذف
200	210	خطأ في الوسيط. انظر `status_message` لمزيد من المعلومات.
400	N/A	سلسلة طلب غير صالحة
401	N/A	رمز `Authorization` مفقود أو غير صالح
500	500	خطأ داخلي

setTags

POST https://api.pushwoosh.com/json/1.3/setTags

يعين قيم العلامات للجهاز. يتم استدعاؤها من SDK.

رؤوس الطلب

الاسم	مطلوب	القيمة	الوصف
Authorization	نعم	Token `XXXX`	رمز جهاز API للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل `XXXX` برمز جهاز API الفعلي الخاص بك.

جسم الطلب

الاسم	النوع	الوصف
application*	string	رمز تطبيق Pushwoosh
hwid*	string	معرف جهاز الجهاز (Hardware ID) المستخدم في طلب /registerDevice.
tags*	object	كائن JSON للعلامات المراد تعيينها، أرسل “null” لإزالة القيمة.

{
   "status_code": 200,
   "status_message": "OK",
   "response": null
}

{
  "request":{
    "application": "XXXXX-XXXXX",               // مطلوب. رمز تطبيق Pushwoosh
    "hwid": "8f65b16XXXXXe7a6becXXXXXe1530fb2", // مطلوب. معرف جهاز الجهاز (Hardware ID) المستخدم في واجهة برمجة تطبيقات /registerDevice
    "tags": {                                   // مطلوب.
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"],        // يعين قائمة القيم للعلامات من نوع القائمة
      "DateTag": "2024-10-02 22:11",            // لاحظ أن الوقت بتوقيت UTC
      "BooleanTag": true                        // القيم الصالحة هي - true, false
    }
  }
}

زيادة قيم علامة العدد الصحيح

لزيادة قيمة علامة العدد الصحيح، استخدم المعلمة operation مع القيمة “increment” كما يلي:

{
  "request":{
    "application": "12345-67890",                   // مطلوب. رمز تطبيق Pushwoosh
    "hwid": "21AB7628-XXXX-XXXX-CCC0-PO287CS24CA4", // مطلوب. معرف جهاز الجهاز (Hardware ID) المستخدم في واجهة برمجة تطبيقات /registerDevice
    "tags": {                                       // مطلوب.
      "Level": {                                    // اسم العلامة
        "operation": "increment",                   // يستبدل علامة العدد الصحيح بزيادات بالقيمة التالية
        "value": 1                                  // الزيادة لقيمة العلامة
      }
    }
  }
}

إنقاص قيم علامة العدد الصحيح

للإنقاص، استخدم الأرقام السالبة كقيمة لعملية “increment” (-1, -2, -3,-n):

{
  "request":{
    "application": "12345-67890",                   // مطلوب. رمز تطبيق Pushwoosh
    "hwid": "21AB7628-XXXX-XXXX-CCC0-PO287CS24CA4", // مطلوب. معرف جهاز الجهاز (Hardware ID) المستخدم في واجهة برمجة تطبيقات /registerDevice
    "tags": {                                       // مطلوب
      "Level": {                                    // اسم العلامة
        "operation": "increment",                   // يستبدل علامة العدد الصحيح بإنقاص بالقيمة التالية
        "value": -1                                 // الإنقاص لقيمة العلامة
      }
    }
  }
}

إلحاق قيم علامة القائمة

لتوسيع علامة القائمة بقيم جديدة، استخدم المعلمة operation مع القيمة “append” كما يلي:

{
  "request": {
    "hwid": "3d124a79XXXXf189XXXX7dfd9XXXXafd", // مطلوب. معرف جهاز الجهاز (Hardware ID) المستخدم في واجهة برمجة تطبيقات /registerDevice
    "application": "6XXXX-XXXX3",               // مطلوب. رمز تطبيق Pushwoosh
    "tags": {                                   // مطلوب.
      "ListTag": {                              // اسم العلامة
        "operation": "append",                  // يلحق القيم التالية بقائمة قيم العلامة
        "value": [                              // القيم المراد إلحاقها
          "tag2",
          "tag3"
        ]
      }
    }
  }
}

إزالة قيم علامة القائمة

لإزالة بعض القيم من علامة القائمة، استخدم عملية “remove” كما يلي:

{
  "request":{
    "application": "12345-67890",                   // مطلوب. رمز تطبيق Pushwoosh
    "hwid": "21AB7628-XXXX-XXXX-CCC0-PO287CS24CA4", // مطلوب. معرف جهاز الجهاز (Hardware ID) المستخدم في واجهة برمجة تطبيقات /registerDevice
    "tags": {                                       // مطلوب.
      "In-App Product": {                           // اسم العلامة
        "operation": "remove",                      // يزيل القيم التالية من علامة القائمة
        "value": "outwear_02"                       // القيمة أو القيم المراد إزالتها
      }
    }
  }
}

تعيين العلامات بواسطة UserID

لتعيين علامات لجميع الأجهزة المرتبطة بـ User ID معين، استخدم المعلمة “userId” بدلاً من “hwid”.

{
  "request":{
    "application": "AAAAA-BBBBB", // رمز تطبيق Pushwoosh
    "userId": "some_user",        // معرف المستخدم الذي ترغب في تعيين علامات له
    "tags": {                     // العلامات والقيم المراد تعيينها
      "Language": "es"
    }
  }
}

رموز الحالة:

رمز حالة HTTP	status_code	الوصف
200	200	تم تعيين العلامات بنجاح
200	210	خطأ في الوسيط. انظر `status_message` لمزيد من المعلومات.
400	N/A	سلسلة طلب غير صالحة
500	500	خطأ داخلي

getTags

POST https://api.pushwoosh.com/json/1.3/getTags

يسترجع قائمة بالعلامات مع القيم المقابلة للجهاز المحدد.

رؤوس الطلب

الاسم	مطلوب	القيمة	الوصف
Authorization	نعم	Token `XXXX`	رمز جهاز API للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل `XXXX` برمز جهاز API الفعلي الخاص بك.

جسم الطلب

الاسم	النوع	الوصف
application*	string	رمز تطبيق Pushwoosh
userId	string	User ID ليتم استخدامه بدلاً من “hwid”. إذا تم استخدامه مع “hwid”، فإن “hwid” له الأسبقية.
hwid	string	معرف جهاز الجهاز (Hardware ID) المستخدم في طلب `/registerDevice`.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "result": {
      "Language": "fr"
    }
  }
}

{
  "request":{
    "application": "XXXXX-XXXXX",   // مطلوب. رمز تطبيق Pushwoosh
    "hwid": "HWID",                 // اختياري. معرف جهاز الجهاز (Hardware ID) المستخدم في واجهة برمجة تطبيقات /registerDevice
    "userId": "USER_ID"             // اختياري. يمكن استخدامه بدلاً من "hwid" لاسترداد العلامات لمستخدم معين
  }
}

setBadge

POST https://api.pushwoosh.com/json/1.3/setBadge

يرسل قيمة الشارة الحالية لجهاز إلى Pushwoosh. يتم استدعاؤها داخليًا من SDK.

رؤوس الطلب

الاسم	مطلوب	القيمة	الوصف
Authorization	نعم	Token `XXXX`	رمز جهاز API للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل `XXXX` برمز جهاز API الفعلي الخاص بك.

جسم الطلب

الاسم	النوع	الوصف
application*	string	رمز تطبيق Pushwoosh
hwid*	string	معرف جهاز الجهاز (Hardware ID) المستخدم في طلب /registerDevice.
badge*	integer	الشارة الحالية على التطبيق.

{
  "status_code": 200,
  "status_message": "OK"
}

{
  "request":{
    "application": "XXXXX-XXXXX",               // مطلوب. رمز تطبيق Pushwoosh
    "hwid": "8f65b16dXXXXe7a6XXXX9614XXXX0fb2", // مطلوب. معرف جهاز الجهاز (Hardware ID) المستخدم في واجهة برمجة تطبيقات /registerDevice
    "badge": 4                                  // مطلوب. الشارة الحالية على التطبيق
  }
}

يتم استدعاؤها من SDK داخليًا. ترسل قيمة الشارة الحالية لجهاز إلى Pushwoosh. يحدث هذا داخليًا عندما يغير التطبيق قيمة الشارة على جهاز iOS. يسمح للشارات ذات الزيادة التلقائية بالعمل بشكل صحيح.

applicationOpen

POST https://api.pushwoosh.com/json/1.3/applicationOpen

يسجل حدث فتح التطبيق. يتم استدعاؤها داخليًا من SDK.

رؤوس الطلب

الاسم	مطلوب	القيمة	الوصف
Authorization	نعم	Token `XXXX`	رمز جهاز API للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل `XXXX` برمز جهاز API الفعلي الخاص بك.

جسم الطلب

الاسم	النوع	الوصف
application*	string	رمز تطبيق Pushwoosh
hwid*	string	معرف جهاز الجهاز (Hardware ID) المستخدم في طلب `/registerDevice`.

{
  "status_code": 200,
  "status_message": "OK"
}

{
  "request": {
    "application": "XXXXX-XXXXX",              // مطلوب. رمز تطبيق Pushwoosh
    "hwid": "8f65b16dXXXXe7a6XXXX9614eXXXXfb2" // مطلوب. معرف جهاز الجهاز (Hardware ID) المستخدم في واجهة برمجة تطبيقات /registerDevice
  }
}

pushStat

POST https://api.pushwoosh.com/json/1.3/pushStat

يسجل حدث فتح إشعار الدفع. يتم استدعاؤها داخليًا من SDK.

رؤوس الطلب

الاسم	مطلوب	القيمة	الوصف
Authorization	نعم	Token `XXXX`	رمز جهاز API للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل `XXXX` برمز جهاز API الفعلي الخاص بك.

جسم الطلب

الاسم	النوع	الوصف
application*	string	رمز تطبيق Pushwoosh
hwid*	string	معرف جهاز الجهاز (Hardware ID) المستخدم في طلب /registerDevice.
userId	string	User ID لربطه بحدث فتح إشعار الدفع.
hash	string	علامة التجزئة (Hash tag) المستلمة في إشعار الدفع (معلمة “p” في حمولة الدفع).

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

{
  "request": {
    "application": "XXXXX-XXXXX",               // مطلوب. رمز تطبيق Pushwoosh
    "hwid": "8f65b16dfXXXX7a6beXXXX14e1530fb2", // مطلوب. معرف جهاز الجهاز (Hardware ID) المستخدم في واجهة برمجة تطبيقات /registerDevice
    "userId": "USER012345",                     // اختياري. معرف المستخدم لربطه بحدث فتح إشعار الدفع
    "hash": "HASH_TAG"                          // اختياري. علامة التجزئة (Hash tag) المستلمة في إشعار الدفع
                                                //           (معلمة "p" في حمولة الدفع)
  }
}

messageDeliveryEvent

POST https://api.pushwoosh.com/json/1.3/messageDeliveryEvent

يسجل حدث تسليم إشعار الدفع للجهاز. يتم استدعاؤها داخليًا من SDK.

رؤوس الطلب

الاسم	مطلوب	القيمة	الوصف
Authorization	نعم	Token `XXXX`	رمز جهاز API للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل `XXXX` برمز جهاز API الفعلي الخاص بك.

جسم الطلب

الاسم	النوع	الوصف
application*	string	رمز تطبيق Pushwoosh
hwid*	string	معرف جهاز الجهاز (Hardware ID) المستخدم في طلب `/registerDevice`.
hash	string	علامة التجزئة (Hash tag) المستلمة في إشعار الدفع (معلمة “p” في حمولة الدفع).

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

 {
  "request": {
    "application": "XXXXX-XXXXX",               // مطلوب. رمز تطبيق Pushwoosh
    "hwid": "8f65b16dfXXXX7a6bece9XXXX1530fb2", // مطلوب. معرف جهاز الجهاز (Hardware ID) المستخدم في واجهة برمجة تطبيقات /registerDevice
    "hash": "HASH_TAG"                          // اختياري. علامة التجزئة (Hash tag) المستلمة في إشعار الدفع
                                                //           (معلمة "p" في حمولة الدفع)
  }
}