واجهة برمجة تطبيقات الجهاز (Device API)
registerDevice
Anchor link toPOST https://api.pushwoosh.com/json/1.3/registerDevice
يتم استدعاؤها داخليًا من SDK. تسجل الجهاز للتطبيق.
ترويسات الطلب
Anchor link to| الاسم | مطلوب | القيمة | الوصف |
|---|---|---|---|
| Authorization | نعم | Token XXXX | رمز API للجهاز للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل XXXX برمز API الفعلي لجهازك. |
نص الطلب
Anchor link to| الاسم | النوع | الوصف |
|---|---|---|
| application* | string | رمز تطبيق Pushwoosh |
| push_token | string | رمز الدفع (Push token) للجهاز. |
| language | string | اللغة المحلية للجهاز. يجب أن يكون رمزًا من حرفين صغيرين وفقًا لمعيار ISO-639-1. |
| hwid* | string | سلسلة فريدة لتعريف الجهاز (IDFV على iOS، قيمة يتم إنشاؤها عشوائيًا على Android). اعرف المزيد |
| timezone | integer | إزاحة المنطقة الزمنية بالثواني للجهاز. |
| device_type* | integer | نوع الجهاز. انظر القيم الممكنة أدناه. |
| string | عنوان البريد الإلكتروني للتسجيل (يُستخدم لمستخدمي البريد الإلكتروني بدلاً من HWID ورمز الدفع). | |
| 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 device 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
- 13 – Internet Explorer
- 14 – البريد الإلكتروني
- 17 – Huawei
- 18 – SMS
- 20 – الويب
- 21 – WhatsApp
- 22 – Line
- 23 – Kakao Talk
- 24 – Telegram
- 25 – Apple Wallet
- 26 – Google Wallet
- 27 – Viber
تسجيل أجهزة البريد الإلكتروني
Anchor link toلتسجيل مشترك بريد إلكتروني لتطبيقك، أرسل المعلمة "email": "email_address@domain.com" في طلب /registerDevice أو /registerEmail الخاص بك كما يلي:
مثال على الطلب
Anchor link to{ "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
Anchor link toلتسجيل جهاز WhatsApp لتطبيقك، اتبع هذه الإرشادات:
-
hwid: تأكد من أن هذا الحقل يتضمن البادئة
whatsapp:متبوعة برقم الهاتف بتنسيق E.164 (على سبيل المثال،whatsapp:+0000000000). يجب أن يكون رقم الهاتف صالحًا، وهو ما سيتحقق منه Pushwoosh. -
رمز الدفع (Push token): لا يلزم وجود رمز دفع، حيث سيعمل
hwidتلقائيًا كرمز دفع. -
device_type: اضبط هذا الحقل على
21لتحديد WhatsApp كمنصة.
مثال على الطلب
Anchor link to{ "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
Anchor link toلتسجيل جهاز SMS لتطبيقك، اتبع هذه الإرشادات:
-
hwid: تأكد من أن هذا الحقل يتضمن رقم الهاتف بتنسيق E.164 (على سبيل المثال،
+0000000000). يجب أن يكون رقم الهاتف صالحًا، وهو ما سيتحقق منه Pushwoosh. -
رمز الدفع (Push token): لا يلزم وجود رمز دفع، حيث سيعمل
hwidتلقائيًا كرمز دفع. -
device_type: اضبط هذا الحقل المطلوب على
18لتحديد SMS كمنصة.
مثال على الطلب
Anchor link to{ "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
Anchor link toPOST https://api.pushwoosh.com/json/1.3/unregisterDevice
يزيل رمز الدفع للجهاز. لا يزال الجهاز غير المسجل يُحتسب في إجمالي الأجهزة ويمكن الوصول إليه باستخدام In-Apps. يتم استدعاؤها داخليًا من SDK.
ترويسات الطلب
Anchor link to| الاسم | مطلوب | القيمة | الوصف |
|---|---|---|---|
| Authorization | نعم | Token XXXX | رمز API للجهاز للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل XXXX برمز API الفعلي لجهازك. |
نص الطلب
Anchor link to| الاسم | النوع | الوصف |
|---|---|---|
| application* | string | رمز تطبيق Pushwoosh |
| hwid* | string | معرف الجهاز (Hardware device ID) المستخدم في طلب /registerDevice. |
{ "status_code": 200, "status_message": "OK", "response": null}{ "request": { "application": "XXXXX-XXXXX", // مطلوب. رمز تطبيق Pushwoosh "hwid": "8f65b16XXXXXe7a6beceXXXXX530fb2" // مطلوب. معرف الجهاز (Hardware device ID) المستخدم في واجهة برمجة تطبيقات /registerDevice }}رموز الحالة:
| رمز حالة HTTP | status_code | الوصف |
|---|---|---|
| 200 | 200 | تم إلغاء اشتراك الجهاز بنجاح |
| 200 | 210 | خطأ في الوسيطة. انظر status_message لمزيد من المعلومات. |
| 400 | N/A | سلسلة طلب غير صالحة |
| 500 | 500 | خطأ داخلي |
deleteDevice
Anchor link toPOST https://api.pushwoosh.com/api/v2/device-api/deleteDevice
يحذف جهازًا وجميع بياناته المرتبطة به المحددة بواسطة HWID المحدد داخل التطبيق. على عكس /unregisterDevice، الذي يزيل فقط رمز الدفع ويحتفظ بسجل الجهاز، فإن /deleteDevice يزيل الجهاز بالكامل. تتم معالجة الطلب بشكل غير متزامن، وتعيد نقطة النهاية 200 OK بمجرد قبول طلب الحذف للمعالجة.
ترويسات الطلب
Anchor link to| الاسم | مطلوب | القيمة | الوصف |
|---|---|---|---|
| Authorization | نعم | Token XXXX | رمز API للجهاز للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل XXXX برمز API الفعلي لجهازك. |
| Content-Type | نعم | application/json |
نص الطلب
Anchor link to| الاسم | مطلوب | النوع | الوصف |
|---|---|---|---|
| application | نعم | string | رمز تطبيق Pushwoosh |
| hwid | نعم | string | معرف الجهاز (Hardware device ID) للجهاز المراد حذفه. |
مثال على الطلب
Anchor link to{ "application": "XXXXX-XXXXX", // مطلوب. رمز تطبيق Pushwoosh "hwid": "8f65b16df378e7a6bece9614e1530fb2" // مطلوب. معرف الجهاز (Hardware device ID) للجهاز المراد حذفه}مثال على الاستجابة
Anchor link to{ "status_code": 200, "status_message": "OK", "response": null}رموز الحالة
Anchor link to| رمز حالة HTTP | status_code | الوصف |
|---|---|---|
| 200 | 200 | تم قبول طلب الحذف |
| 200 | 210 | خطأ في الوسيطة. انظر status_message لمزيد من المعلومات. |
| 400 | N/A | سلسلة طلب غير صالحة |
| 401 | N/A | رمز Authorization مفقود أو غير صالح |
| 500 | 500 | خطأ داخلي |
setTags
Anchor link toPOST https://api.pushwoosh.com/json/1.3/setTags
يضبط قيم العلامات للجهاز. يتم استدعاؤها من SDK.
ترويسات الطلب
Anchor link to| الاسم | مطلوب | القيمة | الوصف |
|---|---|---|---|
| Authorization | نعم | Token XXXX | رمز API للجهاز للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل XXXX برمز API الفعلي لجهازك. |
نص الطلب
Anchor link to| الاسم | النوع | الوصف |
|---|---|---|
| application* | string | رمز تطبيق Pushwoosh |
| hwid* | string | معرف الجهاز (Hardware device ID) المستخدم في طلب /registerDevice. |
| tags* | object | كائن JSON للعلامات المراد تعيينها، أرسل “null” لإزالة القيمة. |
{ "status_code": 200, "status_message": "OK", "response": null}{ "request":{ "application": "XXXXX-XXXXX", // مطلوب. رمز تطبيق Pushwoosh "hwid": "8f65b16XXXXXe7a6becXXXXXe1530fb2", // مطلوب. معرف الجهاز (Hardware device ID) المستخدم في واجهة برمجة تطبيقات /registerDevice "tags": { // مطلوب. "StringTag": "string value", "IntegerTag": 42, "ListTag": ["string1", "string2"], // يضبط قائمة القيم للعلامات من نوع القائمة "DateTag": "2024-10-02 22:11", // لاحظ أن الوقت بتوقيت UTC "BooleanTag": true // القيم الصالحة هي - true, false } }}زيادة قيم علامة Integer
Anchor link toلزيادة قيمة علامة Integer، استخدم المعلمة operation مع القيمة “increment” كما يلي:
{ "request":{ "application": "12345-67890", // مطلوب. رمز تطبيق Pushwoosh "hwid": "21AB7628-XXXX-XXXX-CCC0-PO287CS24CA4", // مطلوب. معرف الجهاز (hardware device ID) المستخدم في واجهة برمجة تطبيقات /registerDevice "tags": { // مطلوب. "Level": { // اسم العلامة "operation": "increment", // يكتب فوق علامة العدد الصحيح بزيادات بالقيمة التالية "value": 1 // الزيادة لقيمة العلامة } } }}إنقاص قيم علامة Integer
Anchor link toللإنقاص، استخدم الأرقام السالبة كقيمة لعملية “increment” (-1, -2, -3,-n):
{ "request":{ "application": "12345-67890", // مطلوب. رمز تطبيق Pushwoosh "hwid": "21AB7628-XXXX-XXXX-CCC0-PO287CS24CA4", // مطلوب. معرف الجهاز (Hardware device ID) المستخدم في واجهة برمجة تطبيقات /registerDevice "tags": { // مطلوب "Level": { // اسم العلامة "operation": "increment", // يكتب فوق علامة العدد الصحيح بإنقاص بالقيمة التالية "value": -1 // الإنقاص لقيمة العلامة } } }}إلحاق قيم علامة List
Anchor link toلتوسيع علامة List بقيم جديدة، استخدم المعلمة operation مع القيمة “append” كما يلي:
{ "request": { "hwid": "3d124a79XXXXf189XXXX7dfd9XXXXafd", // مطلوب. معرف الجهاز (Hardware device ID) المستخدم في واجهة برمجة تطبيقات /registerDevice "application": "6XXXX-XXXX3", // مطلوب. رمز تطبيق Pushwoosh "tags": { // مطلوب. "ListTag": { // اسم العلامة "operation": "append", // يلحق القيم التالية بقائمة قيم العلامة "value": [ // القيم المراد إلحاقها "tag2", "tag3" ] } } }}إزالة قيم علامة List
Anchor link toلإزالة بعض القيم من علامة List، استخدم عملية “remove” كما يلي:
{ "request":{ "application": "12345-67890", // مطلوب. رمز تطبيق Pushwoosh "hwid": "21AB7628-XXXX-XXXX-CCC0-PO287CS24CA4", // مطلوب. معرف الجهاز (Hardware device ID) المستخدم في واجهة برمجة تطبيقات /registerDevice "tags": { // مطلوب. "In-App Product": { // اسم العلامة "operation": "remove", // يزيل القيم التالية من علامة القائمة "value": "outwear_02" // القيمة أو القيم المراد إزالتها } } }}تعيين العلامات بواسطة UserID
Anchor link toلتعيين علامات لجميع الأجهزة المرتبطة بـ 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
Anchor link toPOST https://api.pushwoosh.com/json/1.3/getTags
يسترجع قائمة بالعلامات مع القيم المقابلة للجهاز المحدد.
ترويسات الطلب
Anchor link to| الاسم | مطلوب | القيمة | الوصف |
|---|---|---|---|
| Authorization | نعم | Token XXXX | رمز API للجهاز للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل XXXX برمز API الفعلي لجهازك. |
نص الطلب
Anchor link to| الاسم | النوع | الوصف |
|---|---|---|
| application* | string | رمز تطبيق Pushwoosh |
| userId | string | User ID ليتم استخدامه بدلاً من “hwid”. إذا تم استخدامه مع “hwid”، فإن “hwid” يسود. |
| hwid | string | معرف الجهاز (Hardware device ID) المستخدم في طلب /registerDevice. |
{ "status_code": 200, "status_message": "OK", "response": { "result": { "Language": "fr" } }}{ "request":{ "application": "XXXXX-XXXXX", // مطلوب. رمز تطبيق Pushwoosh "hwid": "HWID", // اختياري. معرف الجهاز (Hardware device ID) المستخدم في واجهة برمجة تطبيقات /registerDevice "userId": "USER_ID" // اختياري. يمكن استخدامه بدلاً من "hwid" لاسترداد العلامات لمستخدم معين }}setBadge
Anchor link toPOST https://api.pushwoosh.com/json/1.3/setBadge
يرسل قيمة الشارة الحالية لجهاز إلى Pushwoosh. يتم استدعاؤها داخليًا من SDK.
ترويسات الطلب
Anchor link to| الاسم | مطلوب | القيمة | الوصف |
|---|---|---|---|
| Authorization | نعم | Token XXXX | رمز API للجهاز للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل XXXX برمز API الفعلي لجهازك. |
نص الطلب
Anchor link to| الاسم | النوع | الوصف |
|---|---|---|
| application* | string | رمز تطبيق Pushwoosh |
| hwid* | string | معرف الجهاز (Hardware device ID) المستخدم في طلب /registerDevice. |
| badge* | integer | الشارة الحالية على التطبيق. |
{ "status_code": 200, "status_message": "OK"}{ "request":{ "application": "XXXXX-XXXXX", // مطلوب. رمز تطبيق Pushwoosh "hwid": "8f65b16dXXXXe7a6XXXX9614XXXX0fb2", // مطلوب. معرف الجهاز (Hardware device ID) المستخدم في واجهة برمجة تطبيقات /registerDevice "badge": 4 // مطلوب. الشارة الحالية على التطبيق }}يتم استدعاؤها من SDK داخليًا. ترسل قيمة الشارة الحالية لجهاز إلى Pushwoosh. يحدث هذا داخليًا عندما يغير التطبيق قيمة الشارة على جهاز iOS. يسمح للشارات ذات الزيادة التلقائية بالعمل بشكل صحيح.
applicationOpen
Anchor link toPOST https://api.pushwoosh.com/json/1.3/applicationOpen
يسجل حدث فتح التطبيق. يتم استدعاؤها داخليًا من SDK.
ترويسات الطلب
Anchor link to| الاسم | مطلوب | القيمة | الوصف |
|---|---|---|---|
| Authorization | نعم | Token XXXX | رمز API للجهاز للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل XXXX برمز API الفعلي لجهازك. |
نص الطلب
Anchor link to| الاسم | النوع | الوصف |
|---|---|---|
| application* | string | رمز تطبيق Pushwoosh |
| hwid* | string | معرف الجهاز (Hardware device ID) المستخدم في طلب /registerDevice. |
{ "status_code": 200, "status_message": "OK"}{ "request": { "application": "XXXXX-XXXXX", // مطلوب. رمز تطبيق Pushwoosh "hwid": "8f65b16dXXXXe7a6XXXX9614eXXXXfb2" // مطلوب. معرف الجهاز (Hardware device ID) المستخدم في واجهة برمجة تطبيقات /registerDevice }}pushStat
Anchor link toPOST https://api.pushwoosh.com/json/1.3/pushStat
يسجل حدث فتح إشعار دفع. يتم استدعاؤها داخليًا من SDK.
ترويسات الطلب
Anchor link to| الاسم | مطلوب | القيمة | الوصف |
|---|---|---|---|
| Authorization | نعم | Token XXXX | رمز API للجهاز للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل XXXX برمز API الفعلي لجهازك. |
نص الطلب
Anchor link to| الاسم | النوع | الوصف |
|---|---|---|
| application* | string | رمز تطبيق Pushwoosh |
| hwid* | string | معرف الجهاز (Hardware device ID) المستخدم في طلب /registerDevice. |
| userId | string | User ID لربطه بحدث فتح الإشعار. |
| hash | string | علامة الهاش المستلمة في إشعار الدفع (معلمة “p” في حمولة الدفع). |
{ "status_code": 200, "status_message": "OK", "response": null}{ "request": { "application": "XXXXX-XXXXX", // مطلوب. رمز تطبيق Pushwoosh "hwid": "8f65b16dfXXXX7a6beXXXX14e1530fb2", // مطلوب. معرف الجهاز (Hardware device ID) المستخدم في واجهة برمجة تطبيقات /registerDevice "userId": "USER012345", // اختياري. معرف المستخدم لربطه بحدث فتح الإشعار "hash": "HASH_TAG" // اختياري. علامة الهاش المستلمة في إشعار الدفع // (معلمة "p" في حمولة الدفع) }}messageDeliveryEvent
Anchor link toPOST https://api.pushwoosh.com/json/1.3/messageDeliveryEvent
يسجل حدث تسليم إشعار الدفع للجهاز. يتم استدعاؤها داخليًا من SDK.
ترويسات الطلب
Anchor link to| الاسم | مطلوب | القيمة | الوصف |
|---|---|---|---|
| Authorization | نعم | Token XXXX | رمز API للجهاز للوصول إلى واجهة برمجة تطبيقات الجهاز. استبدل XXXX برمز API الفعلي لجهازك. |
نص الطلب
Anchor link to| الاسم | النوع | الوصف |
|---|---|---|
| application* | string | رمز تطبيق Pushwoosh |
| hwid* | string | معرف الجهاز (Hardware device ID) المستخدم في طلب /registerDevice. |
| hash | string | علامة الهاش المستلمة في إشعار الدفع (معلمة “p” في حمولة الدفع). |
{ "status_code": 200, "status_message": "OK", "response": null} { "request": { "application": "XXXXX-XXXXX", // مطلوب. رمز تطبيق Pushwoosh "hwid": "8f65b16dfXXXX7a6bece9XXXX1530fb2", // مطلوب. معرف الجهاز (Hardware device ID) المستخدم في واجهة برمجة تطبيقات /registerDevice "hash": "HASH_TAG" // اختياري. علامة الهاش المستلمة في إشعار الدفع // (معلمة "p" في حمولة الدفع) }}