روابط الدفع (من غير كود)
استخدم الرابط اللي التاجر أنشأه في لوحة التحكم. ضمّنه في موقع، حطّه في إيميل، اطبع كود QR، أو استنى أحداث الدفع بـ webhook.
روابط الدفع ميزة من غير كود. بتتعمل في لوحة التحكم، مش عن طريق الـ API. الصفحة دي بتغطي تعمل إيه بالرابط بعد ما يبقى موجود: إزاي تحطّه في السطوح بتاعتك، والـ URL شكله إيه، وإزاي تأكّد الدفعات برمجيًا لو حبيت.
رابط الـ URL
كل رابط دفع ليه URL بالشكل ده:
https://checkout.xpay.app/p/{paymentLinkId}الـ paymentLinkId هو معرّف الرابط من لوحة التحكم، ببادئة plink_test_* في وضع الاختبار وplink_live_* في الحساب الفعلي. اسم المضيف (hostname) واحد في الوضعين؛ البادئة هي اللي بتقولك الرابط بيخص أنهي بيئة.
افتح صفحة تفاصيل الرابط في لوحة التحكم واضغط نسخ الرابط علشان تاخد الـ URL، أو عرض رمز QR علشان تحمّل كود QR قابل للطباعة.
استخدم الرابط
الـ URL ده URL عادي بـ HTTPS. استخدمه في أي مكان بيشتغل فيه URL.
رابط أو زرار في موقعك
<a href="https://checkout.xpay.app/p/plink_..."> بيفتح الدفع المستضاف في نفس التاب. ضيف target="_blank" علشان يفتح في تاب جديد.
كود QR على ورق أو شاشة
لوحة التحكم بتولّد كود QR قابل للطباعة. الزقه على بوستر، أو فلاير، أو ترابيزة مطعم، أو اعرضه على شاشة كاشير.
إيميل، شات، سوشيال
حطّ الـ URL في إيميل معاملاتي، أو رسالة Slack، أو bio على إنستجرام، أو رسالة واتساب. الرابط بيشتغل في أي قناة بتعرض URLs.
Webflow، Wix، Squarespace، Shopify
أغلب منشئي المواقع من غير كود بيقبلوا URL مخصّص على زرار أو صورة. الصق الرابط هناك. من غير script tag، ولا SDK، ولا embed.
رابط واحد، عملاء كتير
نفس رابط الدفع بيتقبل من عدد لا نهائي من العملاء. تفاعل كل عميل قايم بذاته: بطاقته، وفورمه، وإيصاله.
ده مفيد للفواتير اللي بتعيد إرسالها، أو البوسترات اللي بتفضل معلّقة أسابيع، أو زراير "اشتري دلوقتي" الدائمة. وبيبقى مشكلة لو الرابط بيحكم بيعة واحدة أو خانة محدودة. للبيعات الفريدة، عطّل الرابط بعد ما العميل يدفع (صفحة القائمة، إجراء جماعي) علشان الـ URL يبطّل يقبل دفعات جديدة.
أكّد الدفعات برمجيًا (اختياري)
مش محتاج كود علشان تحصّل دفعات عن طريق رابط دفع. لوحة التحكم بتعرضلك أصلًا كل معاملة، وكل عميل، وكل تسوية جت من خلاله.
ما تلجأش للكود إلا لما تحتاج رد فعل مؤتمت على كل دفعة ناجحة: منح وصول، أو إرسال إيصال بإيميل متتبَّع، أو نشر لنظام المخزن بتاعك، أو تحديث CRM داخلي. علشان كده، اظبط نقطة نهاية webhook واستنى أحداث checkout.session.completed.
الحدث ده هو نفس الحدث اللي بيطلقه كل دمج تاني في XPay. حمولة الجلسة بتحمل حقل paymentLinkId بيقولك العميل دفع من خلال أنهي رابط دفع، علشان تقدر تفرّع معالِجك على حسب الرابط.
الحد الأدنى اللي معالِجك محتاج يعمله:
- تحقّق من ترويسة
XPay-Signature. - فُكّ محتوى الـ JSON.
- لو
event.type === "checkout.session.completed"وevent.data.object.paymentLinkId === "plink_..."، اعمل أي تنفيذ عايزه للرابط ده.
للإعداد الكامل (إنشاء نقطة نهاية، والحصول على السرّ بتاع التوقيع، وطريقة التحقق في Node وPython)، شوف مجموعة الـ Webhooks.
إعداد نقطة نهاية webhook
أضِف نقطة نهاية في لوحة التحكم وخُد السرّ بتاع التوقيع whsec_*.
التحقق من التواقيع
التحقق من توقيع HMAC-SHA256 مع الحماية من إعادة التشغيل.
رايح فين بعد كده
أنشئ رابط دفع
شرح لوحة التحكم: المنتجات، والتحصيل، والتأكيد، والمشاركة.
وضع الاختبار وبطاقات الاختبار
افتح URL plink_test_* ببطاقة اختبار علشان تشغّل دفعة من الأول للآخر من غير ما تصرف فلوس.
محتاج دفع متحكَّم فيه بالكود؟
لو عايز تحكم برمجي كامل في كل جلسة، بُص على الدفع المستضاف، أو Drop-in، أو Elements.