- بيانات اعتماد API
- مفتاح API
- سر Webhook
أعدّ Stripe ليدفع المسافرون بالبطاقة في صفحة الدفع الخاصة بـ Stripe، ثم يعودوا إلى حجز مدفوع. تحتاج إلى حساب مصرفي في أحد البلدان المذكورة أعلاه.
إنشاء حسابك على Stripe
- 1
سجّل لدى Stripe
أنشئ الحساب على dashboard.stripe.com/register. واختر بلد النشاط التجاري بعناية: إذ لا يستطيع Stripe تغييره بعد تفعيل الحساب.
- 2
وثّق نشاطك التجاري
أكمل الطلب على dashboard.stripe.com/account/onboarding: بيانات نشاطك التجاري، والأشخاص الذين يقفون وراءه، والحساب المصرفي الذي تُحوَّل إليه مستحقاتك. وتُتاح المدفوعات الفعلية بعد أن يتحقق Stripe منك.
نسخ المفتاح السري من Stripe
- 1
افتح مفاتيح API
انتقل إلى dashboard.stripe.com/apikeys وبدّل من بيئة الاختبار (sandbox) إلى الوضع المباشر.
- 2
انسخ المفتاح السري
ضمن Standard keys، انقر على Reveal live key وانسخ Secret key: يبدأ بـ sk_live_. احتفظ به سرًّا: فأي شخص يملكه يستطيع قبض المدفوعات واستردادها باسمك.
إضافة webhook الخاص بـ TourTask في Stripe
بفضل الـ webhook، يعلم TourTask بكل دفعة، حتى عندما تُسوّى الأموال بعد أيام أو لا يعود المسافر أبدًا.
عنوان webhook الخاص بك في TourTask لـ Stripe
https://api.tourtask.com/v1/payments/stripe/notifications/booking- 1
أنشئ وجهة أحداث
انتقل إلى dashboard.stripe.com/webhooks في الوضع المباشر، وانقر على Create an event destination.
- 2
اختر حسابك وSnapshot
اختر Your account وتنسيق الحمولة Snapshot: إذ لا يستطيع TourTask قراءة أحداث Thin التي يوصي بها Stripe. واترك إصدار API كما هو.
- 3
حدّد الحدثين
حدّد checkout.session.completed وcheckout.session.async_payment_succeeded، ولا شيء غيرهما.
- 4
اختر نقطة نهاية webhook
انقر على Continue واختر Webhook endpoint نوعًا للوجهة.
- 5
أدخل عنوان TourTask
انقر على Continue، والصق عنوان TourTask أعلاه في Endpoint URL، ثم أنشئ الوجهة.
- 6
انسخ سر التوقيع
في صفحة الوجهة، انقر على Reveal secret وانسخ سر التوقيع: يبدأ بـ whsec_.
إضافة Stripe في TourTask
- 1
افتح بطاقة Stripe
انتقل إلى إعدادات ← خيارات الدفع وانقر على بطاقة Stripe ضمن الدفع عبر الإنترنت ← بوابات الدفع. لا تجدها؟ اختر إظهار جميع البوابات أسفل البطاقات.
- 2
اختر الدولة والعملة
في دولة اختر الدولة التي يوجد فيها حسابك لدى Stripe وحسابه المصرفي، وفي عملة العملة التي يدفع بها المسافرون. انقر على إضافة. لتغيير أيٍّ منهما لاحقًا، أزِل Stripe عبر إزالة ثم أضِفها من جديد.
- 3
أدخِل بيانات اعتماد API
ضمن المصادقة تحتوي البطاقة على حقل لكلٍّ منها:
مفتاح API
سر Webhookيُحفَظ كل حقل عند النقر خارجه.
- 4
فعِّل Stripe
انقر على تفعيل بعد ملء جميع الحقول. تصبح البطاقة مُفعَّل، ويمكن للمسافرين الدفع عبر Stripe في صفحة الحجز الخاصة بك. تصل كل دفعة مباشرةً إلى حسابك الخاص لدى Stripe: لا يحتفظ TourTask بأموالك أبدًا.
لإضافة رسوم إضافية أو إعادة ترتيب طرق الدفع، راجع المدفوعات عبر الإنترنت.
التحقق من عمل Stripe
لا يوفّر TourTask وضع اختبار لـ Stripe، وتحظر شروط Stripe إجراء مدفوعات تجريبية ببطاقات حقيقية.
- 1
افتح صفحة الدفع في Stripe
في صفحة الحجز الخاصة بك، احجز جولة واختر Stripe. ستُفتح صفحة الدفع في Stripe: أغلقها دون أن تدفع.
- 2
ألغِ الحجز التجريبي
افتح الحجز في TourTask وانقر على إلغاء الحجز.
- 3
تحقّق من أول دفعة
عندما يدفع مسافر عبر Stripe، يظهر الحجز مدفوعًا وتظهر الدفعة في لوحة تحكم Stripe.
- 4
تحقّق من الـ webhook
في Stripe، افتح علامة التبويب Event deliveries الخاصة بالوجهة: يظهر checkout.session.completed بحالة Delivered. وإذا فشل، فتحقّق من عنوان نقطة النهاية، وتنسيق Snapshot، وسر Webhook.
الأسئلة الشائعة
الطرق المفعّلة في إعدادات طرق الدفع في لوحة تحكم Stripe. والطريقة التي تُسوّى لاحقًا، مثل الخصم المباشر من الحساب المصرفي، لا تُسجّل الحجز مدفوعًا إلا عند وصول الأموال.
لا. يحوّل TourTask إجمالي الحجز إلى العملة التي اخترتها للبوابة.
لا. تذهب المدفوعات إلى حسابك الخاص على Stripe، ثم يحوّلها Stripe إلى مصرفك.