TourTask
المميزاتالأسعارالعرض التوضيحي
إنشاء حساب
Stripe Elements

كيفية قبول الدفع بالبطاقات عبر Stripe Elements

اقبل الدفع بالبطاقات في صفحة الحجز الخاصة بك عبر Stripe Elements.

الدول

  • إسبانيا
  • أستراليا
  • استونيا
  • الإمارات العربية المتحدة
  • البرازيل

العملات

  • AED
  • AFN
  • ALL
  • AMD
  • ANG
  • AOA
  • ARS
الوثائقتواصل معنا
بيانات اعتماد API
  • مفتاح API
  • مفتاح قابل للنشر
  • سر Webhook

يضع Stripe Elements حقول البطاقة من Stripe في صفحة الحجز الخاصة بك، فيدفع المسافرون بالبطاقة دون مغادرتها. تحتاج إلى حساب Stripe يقبل المدفوعات الفعلية: ويشرح دليل Stripe كيفية فتح حساب.

نسخ مفاتيحك من Stripe

  1. 1

    افتح مفاتيح API في الوضع المباشر

    افتح dashboard.stripe.com/apikeys وتأكّد من أنك في الوضع المباشر، لا في بيئة اختبار (sandbox). فمفتاح الاختبار لا يفشل: بل يسجّل الحجوزات مدفوعةً بأموال غير موجودة.

  2. 2

    انسخ المفتاح القابل للنشر

    ضمن Standard keys، انسخ Publishable key. يبدأ بـ pk_live_.

  3. 3

    انسخ المفتاح السري

    انسخ Secret key (انقر على Reveal live key إن كان مخفيًا). يبدأ بـ sk_live_. احتفظ به سرًّا: إذ يمكن به خصم مبالغ من البطاقات باسمك.

إضافة الـ webhook في Stripe

الـ webhook هو ما يسجّل الحجوزات مدفوعة

بدونه، يُخصم المبلغ من المسافرين وتبقى حجوزاتهم غير مؤكدة.

عنوان webhook الخاص بك في TourTask لـ Stripe Elements

https://api.tourtask.com/v1/payments/stripe-elements/notifications/booking
  1. 1

    أنشئ وجهة أحداث

    افتح dashboard.stripe.com/webhooks، وأنت لا تزال في الوضع المباشر، وانقر على Create an event destination.

  2. 2

    اختر حسابك وSnapshot

    اختر Your account وتنسيق الحمولة Snapshot: إذ لا يستطيع TourTask قراءة أحداث Thin التي يوصي بها Stripe.

  3. 3

    حدّد الحدث

    حدّد payment_intent.succeeded ولا حدث غيره.

  4. 4

    اختر نقطة نهاية webhook

    انقر على Continue واختر Webhook endpoint نوعًا للوجهة.

  5. 5

    أدخل عنوان TourTask

    انقر على Continue، والصق عنوان TourTask أعلاه في Endpoint URL، ثم انقر على Create destination.

  6. 6

    انسخ سر التوقيع

    في صفحة الوجهة، انقر على Reveal secret وانسخ سر التوقيع. يبدأ بـ whsec_.

لكل بوابة نقطة نهاية خاصة بها

هل لديك بالفعل نقطة نهاية لبوابة Stripe؟ أضف نقطة جديدة على أي حال: فكل بوابة تحتاج إلى نقطة نهاية خاصة بها.

إضافة Stripe Elements في TourTask

  1. 1

    افتح بطاقة Stripe Elements

    انتقل إلى إعدادات ← خيارات الدفع وانقر على بطاقة Stripe Elements ضمن الدفع عبر الإنترنت ← بوابات الدفع. لا تجدها؟ اختر إظهار جميع البوابات أسفل البطاقات.

  2. 2

    اختر الدولة والعملة

    في دولة اختر الدولة التي يوجد فيها حسابك لدى Stripe Elements وحسابه المصرفي، وفي عملة العملة التي يدفع بها المسافرون. انقر على إضافة. لتغيير أيٍّ منهما لاحقًا، أزِل Stripe Elements عبر إزالة ثم أضِفها من جديد.

  3. 3

    أدخِل بيانات اعتماد API

    ضمن المصادقة تحتوي البطاقة على حقل لكلٍّ منها:
    مفتاح API
    مفتاح قابل للنشر
    سر Webhook

    يُحفَظ كل حقل عند النقر خارجه.

  4. 4

    فعِّل Stripe Elements

    انقر على تفعيل بعد ملء جميع الحقول. تصبح البطاقة مُفعَّل، ويمكن للمسافرين الدفع عبر Stripe Elements في صفحة الحجز الخاصة بك. تصل كل دفعة مباشرةً إلى حسابك الخاص لدى Stripe Elements: لا يحتفظ TourTask بأموالك أبدًا.

مفتاح API: مفتاحك السري sk_live_…
مفتاح قابل للنشر: مفتاحك pk_live_…
سر Webhook: سر التوقيع whsec_…

افتحه افتراضيًا (اختياري)

انقر على مفتوح افتراضيًا في بطاقة البوابة ليظهر نموذج الدفع بالبطاقة مفتوحًا أعلى صفحة الحجز.

التحقق من عمل Stripe Elements

لا يوفّر TourTask وضع اختبار لـ Stripe Elements، وتحظر شروط Stripe إجراء مدفوعات تجريبية ببطاقات حقيقية.

  1. 1

    افتح نموذج البطاقة

    في صفحة الحجز الخاصة بك، احجز جولة واختر الدفع بالبطاقة: يظهر نموذج البطاقة من Stripe. أغلق الصفحة دون أن تدفع.

  2. 2

    ألغِ الحجز التجريبي

    افتح الحجز في TourTask وانقر على إلغاء الحجز.

  3. 3

    تحقّق من أول دفعة

    عندما يدفع مسافر بالبطاقة، يظهر الحجز مدفوعًا وتظهر الدفعة في لوحة تحكم Stripe.

  4. 4

    تحقّق من الـ webhook

    في Stripe، افتح علامة التبويب Event deliveries الخاصة بالوجهة: يظهر payment_intent.succeeded بحالة Delivered.

خُصم المبلغ، لكن الحجز غير مدفوع في TourTask؟

تحقّق من الـ webhook في Stripe: الوضع المباشر، وتنسيق Snapshot، والحدث payment_intent.succeeded، والعنوان الدقيق. وفي TourTask، يجب أن يحتوي سر Webhook على سر التوقيع الخاص بنقطة النهاية هذه. وتعرض علامة التبويب Event deliveries الخاصة بالوجهة في Stripe كل محاولة فاشلة.

إضافة Apple Pay وGoogle Pay

Apple Pay وGoogle Pay بوابتان مستقلتان، تُعدّان مثل Stripe Elements بالمفتاحين نفسيهما. وتحتاج كل منهما إلى نقطة نهاية webhook خاصة بها على عنوانها الخاص، ويوضع سر التوقيع لتلك النقطة في سر Webhook الخاص بها.

Apple Pay

https://api.tourtask.com/v1/payments/apple-pay/notifications/booking

Google Pay

https://api.tourtask.com/v1/payments/google-pay/notifications/booking
سجّل عناوين مواقعك في Stripe

على عكس نموذج البطاقة، لا تظهر أزرار المحافظ الرقمية إلا على العناوين المسجّلة في Stripe ضمن Settings → Payment method domains. سجّل كل عنوان يحجز عليه المسافرون: موقعك الإلكتروني، وyourname.tourtask.com، وموقعك على TourTask (yourname.tourtask.site أو نطاقه الخاص). علمًا بأن example.com وwww.example.com إدخالان منفصلان.

الأسئلة الشائعة

لا. تنتقل بيانات البطاقة مباشرةً من متصفح المسافر إلى Stripe.

يُبقي Stripe Elements المسافرين في صفحة الحجز الخاصة بك، بينما ينقلهم Stripe إلى صفحة Stripe ثم يعيدهم. ويمكنك تشغيل الاثنين معًا.

الطرق المفعّلة في إعدادات طرق الدفع في لوحة تحكم Stripe. والبطاقات مفعّلة افتراضيًا.

لا. يحوّل TourTask إجمالي الحجز إلى العملة التي اخترتها للبوابة.

هل كانت هذه الصفحة مفيدة؟