احجز الويب هوكس (المخزون عند الطلب)

قم بتكوين نقطة نهاية HTTPS لكل عرض تعيد القيم للمدرجات المعقدة. لا يزال يتم إكمال الدفع إذا فشلت المكالمة؛ يمكنك إعادة المحاولة أو التنفيذ يدويًا.

استرجع القيم الخاصة بالتراخيص، الحساب، أو المفاتيح من خادمك عندما يدفع المشتري.

متى تستخدم ويب هوكس الحجز

استخدم هذا للمخزون المعقد (وحدة فريدة) عندما تقوم بإنشاء مفاتيح أو حسابات في نظامك الخاص في وقت الشراء. يُفضل دائمًا المخزون المحلي؛ يملأ الويب هوك فقط النقص.

  • يعمل فقط مع التسليم التلقائي الفوري عندما يتم تعيين كل وحدة بالفعل.
  • قم بتكوين افتراضي على مستوى العرض، أو تجاوز لكل خيار تسعير.
  • HTTPS فقط. يستخدم التوقيع الاختياري HMAC لمطابقة ويب هوكس الصادرة.

فشل آمن للدفع

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

طلب العقد

بعد الدفع، يقوم RMT بإرسال مكالمة واحدة reserve.item لكل وحدة مفقودة مع الطلب، العرض، الخيار، مخطط الحقول، والكمية 1. يتم دمج نموذج الطلب الاختياري JSON مع {{placeholders}}.

جسم POST القياسي (مقتطع)

json
{
  "id": "rsv_…",
  "type": "reserve.item",
  "order": { "uid": "…", "reference": "…", "url": "…" },
  "offer": { "url": "…", "title": "…", "pageUrl": "…" },
  "option": { "id": 1, "name": "قياسي" },
  "fields": [{ "id": 10, "name": "ترخيص", "type": "text", "required": true }],
  "quantity": 1
}

الاستجابة ورسم الخرائط للحقول

أعد 2xx JSON. قم برسم المسارات مثل $.license على حقول العنصر، أو أعد { "entries": [{ "fieldId": 10, "value": "KEY-…" }] }.

استجابة ملائمة

json
{
  "entries": [
    { "name": "ترخيص", "value": "AAAA-BBBB-CCCC" }
  ]
}
  • ترخيص فقط: قم برسم حقل نص واحد من $.license أو $.key.
  • حساب: قم برسم حقول البريد الإلكتروني وكلمة المرور من $.email و$.password.
  • تعتبر الحقول المطلوبة المفقودة بعد الرسم فشلًا.

اختبار، إعادة المحاولة، والأمان

استخدم اختبار في محرر العرض (يرسل dryRun: true). في صفحة الطلب، أعد محاولة الحجز بعد إصلاح نقطة النهاية الخاصة بك. لا تسجل أبدًا الأسرار أو المفاتيح الكاملة في رسائل البريد الإلكتروني.

  1. 1احفظ عنوان URL HTTPS، خريطة الاستجابة، والسر الاختياري في خطوة عناصر العرض.
  2. 2قم بتشغيل اختبار وتأكيد المعاينات المرسومة.
  3. 3في حالة الفشل، افتح الطلب، أعد محاولة الحجز، أو أنشئ/خصص مفتاحًا يدويًا.

لا تقم باستدعاء الحجز قبل الدفع

يتصل RMT فقط بنقطة النهاية الخاصة بك بعد نجاح الدفع، لذا لا تحرق عمليات الشراء المهجورة التراخيص.