Inspector
الصق أي معرّف XPay وشوف الرسم الكامل للموارد المرتبطة بيه، والحمولة بصيغة JSON، والأحداث اللي اتطلقت عليه، وسجلات الطلبات اللي حواليه.
الـ Inspector هو أداة "الحاجة دي إيه؟". إديله أي معرّف XPay وهو يحمّلك المورد، والموارد اللي حواليه، والأحداث اللي اتطلقت عليه، وسجلات الطلبات اللي مسّته، كل ده في لوحة واحدة.
هتلجأ ليه لما تلاقي دفعة شكلها غريب في لوحة التحكم، أو لما تتبّع webhook راجع لمصدره، أو لما يكون عندك معرّف طلب من عندك مرتبط بـ pi_* وعايز تشوف الفلوس راحت فين.
لميكانيكية الدرج (الفتح، السحب، الشاشة الكاملة)، شوف مقدمة الـ Workbench.
افتح الـ Inspector
طريقتين:
- أيقونة القائمة اللي تحت على اليمين (منظار). الأيقونة بتفهم السياق: لما الصفحة اللي أنت فيها يكون فيها معرّف قابل للفحص في الـ URL بتاعها، الأيقونة بتلتقطه وبتعرض المعرّف مختصرًا جنب المنظار. الضغط بيفتح الـ Inspector محمّل مسبقًا بالمورد ده.
- من أي تاب في الـ Workbench، اضغط Inspector في شريط التابات.
لو فتحت الـ Inspector من غير ما يتكتشف أي معرّف، هتلاقي نفسك في شاشة بحث فاضية عنوانها Peek under the hood with Inspector. اكتب أو الصق أي معرّف قابل للفحص في خانة البحث واللوحة هتتملّى.
الفحص التلقائي: اتبع الصفحة
افتراضيًا، الـ Inspector بيتبع لوحة التحكم وأنت بتتنقّل. افتح الـ Workbench مرة وأنت في صفحة معاملة، وادخل على تفاصيل استرداد أو ملف عميل، والـ Inspector بيتحدّث للمورد الجديد من غير ما تكتب أي حاجة.
السلوك ده متحكَّم فيه بمفتاح اسمه Auto-inspect في أسفل الشريط الجانبي للـ Inspector. الوصف بيقول: "Inspector will automatically update based on the resource displayed in the dashboard". طفّيه علشان تثبّت الـ Inspector على مورد واحد وأنت بتتنقّل في باقي لوحة التحكم.
اكتشاف الأيقونة للمعرّف مستقل عن المفتاح ده. الأيقونة بتعرض دايمًا معرّف الصفحة الحالية لما يكون موجود، بغض النظر عن إن الـ Auto-inspect مفعّل ولا لأ.
المعرّفات القابلة للفحص
الـ Inspector بيعرف كل معرّف بادئة (prefix) بيصدره XPay. أشهرهم:
| البادئة | المورد |
|---|---|
cs_ | Checkout SessionAPI |
pi_ | Payment IntentAPI |
ch_ | ChargeAPI |
re_ | RefundAPI |
cus_ | CustomerAPI |
txn_ | Balance TransactionAPI |
plink_ | Payment Link |
prod_ | Product |
price_ | Price |
coupon_ | CouponAPI |
promo_ | Promotion code |
pob_ | Payout Batch |
pm_ | Payment Method |
li_ | Line Item |
evt_ | Event |
لو لصقت معرّف ببادئة الـ Inspector مش عارفها، هيرجّعلك "No object was found matching the ID provided."
الـ Data map
الشريط الجانبي الشمال للـ Inspector هو Data map: شجرة للكيان اللي بتفحصه والموارد المرتبطة بيه. لجلسة دفع، الشجرة بتتوسّع علشان تعرض الـ Payment Intent بتاعها، والـ Charges، والـ Refunds، والـ Balance Transactions، والعميل المربوط بالجلسة، وكلهم قابلين للضغط.
العنوان اللي فوق بيقول Inspecting، وفيه خانة بحث بتخلّيك تبدّل لمعرّف تاني من غير ما تسيب الـ Inspector. تحت عنوان الشجرة (Data map)، رسم الموارد بيظهر. اضغط أي عقدة (node) علشان تبدّل هدف الفحص للمورد ده. اللوحة اليمين بتتحدّث على طول.
الشريط الجانبي بينطوي لشريط أيقونات على الديسكتوب (استخدم زرار التبديل في الهيدر بتاعه)، وبينزلق فوق كورقة (sheet) على الموبايل.
التابات الفرعية
اللوحة اليمين فيها تلات تابات فوق، كلهم في نطاق المورد اللي محدِّده دلوقتي.
| التاب | بيعرض إيه |
|---|---|
| Overview | حمولة الـ JSON الكاملة للمورد. نفس الشكل اللي بيرجّعه GET /<resource>/:id. |
| Logs | سجلات الطلبات من ناحية السيرفر اللي مسّت المورد ده. شوف Logs panel للمرجع الكامل. |
| Events | أحداث webhook اللي اتطلقت على المورد ده (ولمّا "Include related" يكون مفعّل، على الموارد اللي حواليه كمان). شوف Events panel. |
الهيدر اللي فوق التابات بيعرض نوع المورد (PAYMENT INTENT، CHARGE، إلخ) ومسار الـ API المطابق علشان تتأكد بنظرة من المورد اللي بتبصّ عليه.
استخدام نموذجي
تلات أنماط بيلجأ فيها التجّار للـ Inspector:
- webhook اتطلق ومش عارف بيخص إيه. انسخ الـ
evt_*من سجلات معالِجك، الصقه في بحث الـ Inspector، وسّع الـ Data map، وشوف المورد اللي الحدث بيخصّه واللي كان حواليه في الوقت ده. - عميل بيعترض على عملية دفع. افتح المعاملة في لوحة التحكم. أيقونة القائمة بتلتقط الـ
pi_*. افتح الـ Workbench والـ Inspector هيستقر على الـ Payment Intent. اضغط على عقدة الـ Refund في الـ Data map علشان تتأكد لو سبق وعملت استرداد ولا لأ. - بتعمل debug لـ Payment Link وقف فجأة. الصق الـ
plink_*في الـ Inspector. الـ Data map بتعرض جلسات الدفع اللي اتعملت من الرابط، كل واحدة قابلة للضغط. ادخل على آخر جلسة فاشلة، وبدّل لـ Events علشان تشوف السبب.
رايح فين بعد كده
مقدمة الـ Workbench
ميكانيكية الدرج، والتابات الأربعة بنظرة سريعة، وإزاي تفتح الـ Workbench.
Events panel
المرجع الكامل لتاب Events، شامل الفلاتر، والتسليمات، وإعادة الإرسال.
Logs panel
سجلات السيرفر لكل طلب في نطاق المورد اللي محدِّده.
نموذج الكائنات
كل بادئة معناها إيه، وإزاي الموارد بتتركّب مع بعض، وأنهي معرّفات تحتفظ بيها في سجل الطلب بتاعك.
إعداد نقطة نهاية
ناحية الـ webhook: اشترك في الأحداث على الموارد اللي هتفحصها.