عرض تجريبي مباشر

المدفوعات لبرمجيات السفر

تكامل Paddle API: متى يناسب التاجر المسجّل شركة السفر

تبيع Paddle البرمجيات وخدمات SaaS والمنتجات الرقمية نيابةً عنك بصفتها التاجر المسجّل. وهذا يناسب شركة تقنية سفر تحصّل اشتراكاتها الخاصة، لكنه في الغالب الأداة الخطأ لاستلام أموال الرحلات الجوية والفنادق والجولات. توضح هذه الصفحة الفرق، وكيف يعمل تكامل Paddle، وكيف تربطه بـ PHPTRAVELS عندما تناسب حالتك.

  • تاجر مسجّل وليس بوابة دفع
  • مصمَّم للبرمجيات والاشتراكات
  • Webhooks موقَّعة
  • يُربط كتكامل مخصص

نموذجان مختلفان

التاجر المسجّل مقابل بوابة الدفع

بوابة الدفع تنقل الأموال نيابةً عنك: أنت البائع، وشركة الدفع تعالج البطاقة، وتبقى الضرائب والفواتير والاستردادات والنزاعات مسؤوليتك. أما التاجر المسجّل فيخطو خطوة أبعد ويصبح هو البائع في نظر العميل والسلطات الضريبية. وحين يشتري أحدهم عبر Paddle، تبيع Paddle له، وتحصّل ضريبة المبيعات أو ضريبة القيمة المضافة وتوردها، وتصدر الفاتورة، وتعالج الاسترداد القسري، ثم تحوّل إليك حصتك.

يوفّر هذا النموذج على شركة البرمجيات كثيرًا من أعمال الضرائب والامتثال، لكنه يعني أيضًا أن Paddle هي من تقرر ما ترضى ببيعه. فمنصتها مبنية للبرمجيات وSaaS والمنتجات الرقمية، لا لخدمات السفر التي تقدمها شركات الطيران والفنادق ومنظمو الجولات. وتشرح صفحة واجهة API لبوابة الدفع آلية مدفوعات البطاقات عمومًا.

مخطط لتدفق دفع يظهر فيه عميل يدفع عبر الإنترنت بينما تنتقل مسؤوليات الدفع والضريبة والتحويل بين البائع ومزوّد الدفع
السؤالPaddle (تاجر مسجّل)بوابة الدفع
من هو البائع؟Paddle هي البائع المسجّل. إيصال العميل وكشف بطاقته يصدران من جانب Paddle في عملية البيع.أنت البائع. البوابة تعالج الدفعة فقط على حساب التاجر الخاص بك.
من يتولى ضريبة المبيعات وضريبة القيمة المضافة؟تحسب Paddle ضريبة المبيعات وضريبة القيمة المضافة وتحصّلها وتوردها في الأماكن التي تبيع إليها.أنت، عبر تسجيلاتك الضريبية ومحاسبك ونظام فواتيرك.
من يصدر الفاتورة؟تصدر Paddle الفاتورة أو الإيصال للمشتري.يصدرها نظامك الخاص، مثل فاتورة الحجز في لوحة الإدارة.
من يتعامل مع الاسترداد القسري؟تتعامل Paddle مع النزاعات والاسترداد القسري بصفتها البائع.أنت ترد على النزاعات بالأدلة عبر لوحة تحكم البوابة أو واجهة API الخاصة بها.
ماذا يمكنك أن تبيع؟البرمجيات وSaaS والاشتراكات والمنتجات الرقمية، ضمن قواعد الاستخدام المقبول لدى Paddle.المبيعات المادية والخدمية التي توافق عليها البوابة، ومنها حجوزات السفر لدى كثير من تجار السفر.
كيف تحصل على أموالك؟تحوّل Paddle أرباحك بعد خصم رسومها وفق جدول التحويلات لديها.تُسوّى الدفعات المحصَّلة في حساب التاجر أو حسابك المصرفي بعد خصم رسوم البوابة.

الرسوم والدول المدعومة والقائمة الدقيقة للمنتجات المسموح بها تحددها Paddle وتتغير مع الوقت. راجع شروط Paddle نفسها قبل أن تبني خطتك عليها.

مساعد القرار

هل Paddle مناسبة لما تبيعه؟

ابدأ من الشيء الذي يدفع العميل ثمنه. اختر السيناريو الأقرب إلى نشاطك.

01

المسافرون يدفعون مقابل رحلات جوية وفنادق وجولات

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

رأينا

استخدم بوابة دفع

راجع قواعد الاستخدام المقبول لدى Paddle قبل استخدامها لحجوزات السفر. معظم شركات السفر تستلم مدفوعات الحجز عبر بوابة دفع مثل Stripe أو PayPal أو Adyen أو بوابة إقليمية.

02

تبيع برمجيات سفر أو SaaS خاصة بك

أنت مزوّد تقنية سفر، والوكالات تدفع لك اشتراكًا شهريًا أو سنويًا مقابل أداة الحجز أو الوصول إلى API أو إضافة أو بوابة بعلامة بيضاء.

رأينا

قد تناسب Paddle

هذا هو النوع من المبيعات الذي صُمم التاجر المسجّل له: تفوتر Paddle الاشتراك، وتتولى الضريبة في كل بلد، وتحوّل إليك أموالك، فلا تحتاج إلى التسجيل في ضريبة القيمة المضافة في كل مكان يوجد فيه عملاؤك.

03

تبيع حجوزات وبرمجيات

تدير وكالتك موقع حجز للمسافرين، وتمنح في الوقت نفسه ترخيصًا لمنصتها أو أدواتها لوكالات أخرى.

رأينا

استخدم الاثنين منفصلين

استلم مدفوعات الحجز عبر بوابة جاهزة داخل مسار الحجز، وفوتر اشتراكات البرمجيات عبر Paddle. مساران وسجلان منفصلان، لكل منهما المعاملة الضريبية الصحيحة.

كيف يعمل

كيف يعمل تكامل Paddle من البداية إلى النهاية

يعمل Paddle Billing بمنتجات وأسعار تنشئها في Paddle، وبصفحة دفع تفتحها Paddle.js، وبـ Webhooks تخبر خادمك بما حدث.

  1. 01

    المنتجات والأسعار

    تنشئ كل خطة مرة واحدة في Paddle، مثل سعر شهري وسعر سنوي، وتحفظ معرّفات الأسعار في نظامك.

    pri_…

  2. 02

    صفحة دفع Paddle.js

    تحمّل صفحتك Paddle.js وتفتح صفحة الدفع كنافذة منبثقة أو إطار مضمّن مع معرّف السعر ومرجع العميل الخاص بك.

    Paddle.Checkout.open()

  3. 03

    اكتمال المعاملة

    يدفع المشتري، فتخصم Paddle من البطاقة أو المحفظة، وتطبّق الضريبة، وتنشئ معاملة، واشتراكًا إذا كان السعر متكررًا.

    txn_…

  4. 04

    Webhook موقَّع

    ترسل Paddle حدثًا مثل transaction.completed إلى نقطة النهاية لديك، موقَّعًا في الترويسة Paddle-Signature.

    transaction.completed

  5. 05

    نظامك يتصرف

    يتحقق خادمك من التوقيع، ثم يفعّل الحساب أو يجدد الخطة أو يسجّل الدفعة.

    200 OK

احتفظ بمفتاح API على خادمك فقط. يستخدم المتصفح رمزًا منفصلًا من جهة العميل، ولكل من بيئة sandbox والبيئة الحية مفاتيحها وأسعارها وأسرار Webhook الخاصة.

أمان Webhook

التحقق من ترويسة Paddle-Signature

يمكن لأي شخص يعرف عنوان نقطة النهاية لديك أن يزوّر Webhook. والتحقق من التوقيع في كل حدث هو ما يجعل تفعيل حساب بناءً على Webhook آمنًا.

paddle-webhook.php
 1$raw    = file_get_contents("php://input"); 2$header = $_SERVER["HTTP_PADDLE_SIGNATURE"] ?? "";  // ts=…;h1=… 3parse_str(str_replace(";", "&", $header), $sig); 4 5$expected = hash_hmac("sha256", $sig["ts"] . ":" . $raw, $endpointSecret); 6if (!hash_equals($expected, $sig["h1"] ?? "")) { 7    http_response_code(400); exit;            // not from Paddle 8} 9if (time() - (int) $sig["ts"] > $tolerance) exit; // too old1011$event = json_decode($raw, true);12if (alreadyHandled($event["event_id"])) exit;      // repeat delivery13if ($event["event_type"] === "transaction.completed") {14    activatePlan($event["data"]["custom_data"]["account_id"]);15}16http_response_code(200);

مثال توضيحي بلغة PHP الخالصة. اتبع وثائق Paddle الحالية أو حزمة SDK الرسمية للحصول على الصيغة الدقيقة.

  1. 01

    استخدم المحتوى الخام

    يُحسب التوقيع على محتوى الطلب تمامًا كما وصل، لذا اقرأه قبل أن يغيّره أي تحليل لـ JSON.

  2. 02

    الطابع الزمني مع التجزئة

    تحمل الترويسة طابعًا زمنيًا وتجزئة HMAC-SHA256 مصنوعة بالمفتاح السري لنقطة النهاية. أعد بناءها وقارنها بزمن ثابت.

  3. 03

    ارفض الأحداث القديمة والمكررة

    ارفض الأحداث التي طابعها الزمني قديم جدًا، واحفظ معرّف كل حدث حتى لا تُعالَج عملية تسليم مكررة مرتين.

  4. 04

    ابدأ ببيئة sandbox

    ابنِ واختبر على بيئة sandbox الخاصة بـ Paddle ببطاقات تجريبية، ثم انقل المفاتيح والأسعار والسر إلى البيئة الحية.

PHPTRAVELS وPaddle

ربط Paddle بـ PHPTRAVELS

جواب صريح أولًا، ثم الخيارات.

Paddle ليست موصّلًا جاهزًا

Paddle غير موجودة في قائمة بوابات الدفع في PHPTRAVELS وليس لها دليل إعداد منشور. أما البوابات الجاهزة المعروضة أدناه فهي المبنية لاستلام مدفوعات الحجز.

اسأل عن تكامل مخصصجرّب العرض التجريبي للحجز

  • لمدفوعات الحجز: بوابة جاهزة

    فعّل في لوحة الإدارة بوابة جاهزة مثل مدفوعات Stripe أو مدفوعات PayPal بحساب التاجر الخاص بك. صفحة الدفع والاستردادات ومرجع الحجز مرتبطة أصلًا بمسار الحجز، كما تشرح صفحة تكامل بوابات الدفع.

  • لمبيعات البرمجيات: Paddle كتكامل مخصص

    عندما تناسب حالتك قواعد Paddle، يستطيع مطورونا ربطها كـ تكامل API مخصص: صفحة دفع Paddle.js في صفحتك، ونقطة نهاية Webhook مع تحقق من التوقيع، ومدفوعات تُسجَّل مقابل عملائك. يُسعَّر العمل قبل أن يبدأ.

  • أو ابنِه بنفسك على الشيفرة المصدرية

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

جاهزة لمدفوعات الحجز

بوابات الدفع المرتبطة أصلًا بـ PHPTRAVELS

لمدفوعات المسافرين والوكلاء، هذه البوابات جاهزة: تفتح حسابًا لدى المزوّد، وتدخل مفاتيحك في لوحة الإدارة، وتختبر ثم تنطلق مباشرة. القائمة هي القائمة الحية من دليل التكاملات لدينا.

يستطيع الوكلاء الفرعيون أيضًا الدفع من رصيد مسبق الدفع أو حد ائتماني عبر محفظة الوكيل B2B، وهو لا يحتاج إلى أي بوابة.

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

تكامل Paddle API: أسئلة شائعة

تحدّث مع المبيعات

ليس كموصّل جاهز. Paddle غير موجودة في قائمة بوابات الدفع في PHPTRAVELS. وإذا كانت حالتك تناسب قواعد Paddle، مثل بيع اشتراكات برمجياتك الخاصة، فيمكن إضافتها كتكامل مخصص أو أن يبنيها مطوروك على الشيفرة المصدرية المرفقة.

Paddle تاجر مسجّل مبني للبرمجيات وSaaS والمنتجات الرقمية، لذا فهي عادةً ليست الأداة المناسبة للرحلات الجوية أو الفنادق أو الجولات. راجع قواعد الاستخدام المقبول لدى Paddle قبل استخدامها لحجوزات السفر؛ فمعظم شركات السفر تستلم مدفوعات الحجز عبر بوابة دفع مثل Stripe أو PayPal أو Adyen أو بوابة إقليمية.

هو الشركة التي تبيع قانونيًا للعميل. وهي المسؤولة عن تحصيل ضريبة المبيعات أو ضريبة القيمة المضافة وتوريدها، وإصدار الفواتير، ومعالجة الاستردادات والاسترداد القسري، وتظهر في كشف حساب العميل. ومع Paddle، تتولى Paddle هذا الدور وتحوّل إليك أموالك.

البوابة تعالج المدفوعات نيابةً عنك بينما تظل أنت البائع وتتحمل أعمال الضريبة والنزاعات. أما Paddle فتصبح هي البائع، وهذا يزيل تلك الأعباء في مبيعات البرمجيات لكنه يحدّ مما يمكنك بيعه عبرها.

حين تبيع برمجياتك أنت لا الرحلات: أداة حجز أو API أو إضافة أو بوابة بعلامة بيضاء تدفع الوكالات اشتراكًا مقابلها. عندها تستطيع Paddle فوترتها وتولي الضريبة في كل بلد.

ترسل Paddle أحداثًا مثل معاملة مكتملة أو اشتراك مجدَّد إلى عنوان تسجّله. يحمل كل طلب ترويسة Paddle-Signature فيها طابع زمني وتجزئة، يتحقق منها خادمك بالمفتاح السري لنقطة النهاية قبل أن يتصرف.

نعم. لدى Paddle بيئة sandbox منفصلة بحساب خاص بها ومفاتيح API وأسعار وبطاقات تجريبية. ابنِ واختبر هناك، ثم انقل الإعدادات إلى البيئة الحية.

نعم، كمسارين منفصلين: محرك الحجز يستلم مدفوعات المسافرين عبر بوابة جاهزة، وPaddle تفوتر اشتراكات برمجياتك. أبقِ سجلاتهما منفصلة ليحظى كل بيع بالمعاملة الضريبية الصحيحة.

واصل الاستكشاف

المزيد عن المنصة