دموی زنده

پرداخت برای نرم‌افزار سفر

یکپارچه‌سازی Paddle API: کجا فروشنده ثبت‌شده به کسب‌وکار سفر می‌خورد

Paddle نرم‌افزار، SaaS و محصولات دیجیتال را به‌عنوان فروشنده ثبت‌شده از طرف شما می‌فروشد. این برای شرکت فناوری سفری که اشتراک‌های خودش را صورتحساب می‌کند گزینه‌ای قوی است، اما معمولاً ابزار مناسبی برای دریافت پول پرواز، هتل و تور نیست. این صفحه تفاوت را توضیح می‌دهد، می‌گوید یکپارچه‌سازی Paddle چگونه کار می‌کند و اگر مورد استفاده شما بخواند، چطور آن را به PHPTRAVELS وصل کنید.

  • فروشنده ثبت‌شده، نه درگاه
  • ساخته‌شده برای نرم‌افزار و اشتراک
  • وب‌هوک‌های امضاشده
  • اتصال به‌صورت یکپارچه‌سازی سفارشی

دو مدل متفاوت

فروشنده ثبت‌شده در برابر درگاه پرداخت

درگاه پرداخت پول را برای شما جابه‌جا می‌کند: شما فروشنده‌اید، شرکت پرداخت کارت را پردازش می‌کند و مالیات، فاکتور، بازپرداخت و اختلاف‌ها همچنان با شماست. فروشنده ثبت‌شده یک قدم جلوتر می‌رود و در نظر مشتری و مقام‌های مالیاتی خودش فروشنده می‌شود. وقتی کسی از طریق Paddle می‌خرد، Paddle به او می‌فروشد، مالیات فروش یا VAT را دریافت و واریز می‌کند، فاکتور صادر می‌کند، چارج‌بک‌ها را رسیدگی می‌کند و بعد سهم شما را پرداخت می‌کند.

این مدل برای شرکت نرم‌افزاری کار مالیاتی و انطباق زیادی را کم می‌کند، اما یعنی Paddle تصمیم می‌گیرد چه چیزی را حاضر است بفروشد. پلتفرم آن برای نرم‌افزار، SaaS و محصولات دیجیتال ساخته شده، نه برای خدمات سفری که ایرلاین‌ها، هتل‌ها و تورگردان‌ها ارائه می‌کنند. سازوکار کلی پرداخت با کارت در صفحه API درگاه پرداخت آمده است.

نمودار جریان پرداخت که در آن مشتری آنلاین پرداخت می‌کند و مسئولیت‌های پرداخت، مالیات و تسویه میان فروشنده و ارائه‌دهنده پرداخت جابه‌جا می‌شود
پرسشPaddle (فروشنده ثبت‌شده)درگاه پرداخت
فروشنده کیست؟Paddle فروشنده ثبت‌شده است. رسید و صورتحساب کارت مشتری از سمت Paddle صادر می‌شود.شما فروشنده‌اید. درگاه فقط پرداخت را روی حساب پذیرنده شما پردازش می‌کند.
مالیات فروش و VAT با کیست؟Paddle مالیات فروش و VAT را در جاهایی که می‌فروشد محاسبه، دریافت و واریز می‌کند.با شما، از طریق ثبت‌نام‌های مالیاتی، حسابدار و فاکتورکشی خودتان.
فاکتور را چه کسی صادر می‌کند؟Paddle فاکتور یا رسید را برای خریدار صادر می‌کند.سیستم خودتان، مثلاً فاکتور رزرو در پنل مدیریت.
چارج‌بک‌ها را چه کسی رسیدگی می‌کند؟Paddle به‌عنوان فروشنده به اختلاف‌ها و چارج‌بک‌ها رسیدگی می‌کند.شما با مدرک از طریق داشبورد یا API درگاه به اختلاف‌ها پاسخ می‌دهید.
چه چیزی می‌توانید بفروشید؟نرم‌افزار، SaaS، اشتراک و محصولات دیجیتال، در چارچوب قوانین استفاده مجاز Paddle.فروش کالا و خدماتی که درگاه تأیید می‌کند، از جمله رزرو سفر برای بسیاری از پذیرندگان حوزه سفر.
پولتان چگونه می‌رسد؟Paddle درآمد شما را پس از کسر کارمزد خودش و طبق زمان‌بندی پرداخت خودش واریز می‌کند.پرداخت‌های برداشت‌شده، پس از کسر کارمزد درگاه، به حساب پذیرنده یا بانکی شما تسویه می‌شود.

کارمزدها، کشورهای پشتیبانی‌شده و فهرست دقیق محصولات مجاز را Paddle تعیین می‌کند و با گذر زمان تغییر می‌کند. پیش از برنامه‌ریزی روی آن، شرایط خود Paddle را بررسی کنید.

راهنمای تصمیم

آیا Paddle برای چیزی که می‌فروشید مناسب است؟

از چیزی شروع کنید که مشتری بابتش پول می‌دهد. سناریویی را انتخاب کنید که به کسب‌وکار شما نزدیک‌تر است.

01

مسافران برای پرواز، هتل و تور پول می‌دهند

مشتری سفری می‌خرد که ایرلاین، هتل یا تورگردان اجرا می‌کند. این پرداخت‌ها اغلب به تأیید همین حالا و برداشت بعداً، بازپرداخت جزئی پس از هزینه لغو و پرداخت چندارزی نیاز دارند.

نظر ما

از درگاه پرداخت استفاده کنید

پیش از استفاده از Paddle برای رزرو سفر، قوانین استفاده مجاز آن را بررسی کنید. بیشتر کسب‌وکارهای سفر پرداخت رزرو را از طریق درگاهی مثل Stripe، PayPal، Adyen یا یک درگاه منطقه‌ای می‌گیرند.

02

نرم‌افزار یا SaaS سفر خودتان را می‌فروشید

شما تأمین‌کننده فناوری سفر هستید و آژانس‌ها برای ابزار رزرو، دسترسی به API، یک افزونه یا یک پورتال وایت‌لیبل به شما اشتراک ماهانه یا سالانه می‌پردازند.

نظر ما

Paddle می‌تواند مناسب باشد

فروشنده ثبت‌شده دقیقاً برای همین نوع فروش ساخته شده: Paddle اشتراک را صورتحساب می‌کند، مالیات هر کشور را رسیدگی می‌کند و به شما پرداخت می‌کند، پس لازم نیست در همه جاهایی که مشتری دارید برای VAT ثبت‌نام کنید.

03

هم رزرو می‌فروشید و هم نرم‌افزار

آژانس شما سایت رزرو برای مسافران دارد و در عین حال پلتفرم یا ابزارهایش را به آژانس‌های دیگر لایسنس می‌دهد.

نظر ما

از هر دو استفاده کنید، جدا از هم

پرداخت رزرو را در جریان رزرو با یک درگاه آماده بگیرید و اشتراک‌های نرم‌افزار را با Paddle صورتحساب کنید. دو جریان، دو دسته سوابق، هرکدام با رفتار مالیاتی درست خودش.

چگونه کار می‌کند

یکپارچه‌سازی Paddle از ابتدا تا انتها چگونه کار می‌کند

Paddle Billing با محصولات و قیمت‌هایی که در Paddle می‌سازید، صفحه پرداختی که Paddle.js باز می‌کند و وب‌هوک‌هایی که به سرور شما می‌گویند چه شده کار می‌کند.

  1. 01

    محصولات و قیمت‌ها

    هر طرح را یک‌بار در Paddle می‌سازید، مثلاً یک قیمت ماهانه و یک قیمت سالانه، و شناسه‌های قیمت را در سیستم خودتان نگه می‌دارید.

    pri_…

  2. 02

    صفحه پرداخت Paddle.js

    صفحه شما Paddle.js را بارگذاری می‌کند و پرداخت را با شناسه قیمت و مرجع مشتری خودتان به‌صورت پنجره روی صفحه یا قاب درون‌صفحه‌ای باز می‌کند.

    Paddle.Checkout.open()

  3. 03

    تراکنش کامل می‌شود

    خریدار پرداخت می‌کند، Paddle از کارت یا کیف پول برداشت می‌کند، مالیات را اعمال می‌کند و یک تراکنش می‌سازد، و اگر قیمت تکرارشونده باشد یک اشتراک هم.

    txn_…

  4. 04

    وب‌هوک امضاشده

    Paddle رویدادی مثل transaction.completed را به نقطه پایانی شما می‌فرستد که در هدر Paddle-Signature امضا شده است.

    transaction.completed

  5. 05

    سیستم شما اقدام می‌کند

    سرور شما امضا را بررسی می‌کند و بعد حساب را فعال می‌کند، طرح را تمدید می‌کند یا پرداخت را ثبت می‌کند.

    200 OK

کلید API را فقط روی سرور خودتان نگه دارید. مرورگر از توکن جداگانه سمت کلاینت استفاده می‌کند و محیط‌های sandbox و واقعی هرکدام کلید، قیمت و راز وب‌هوک خودشان را دارند.

امنیت وب‌هوک

بررسی هدر Paddle-Signature

هر کسی که نشانی نقطه پایانی شما را بداند می‌تواند وب‌هوک جعل کند. بررسی امضا در هر رویداد است که فعال‌سازی حساب بر پایه وب‌هوک را ایمن می‌کند.

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 پدل بسازید و آزمایش کنید، بعد کلیدها، قیمت‌ها و راز را به محیط واقعی ببرید.

PHPTRAVELS و Paddle

اتصال Paddle به PHPTRAVELS

اول یک پاسخ صادقانه، بعد گزینه‌ها.

Paddle اتصال‌دهنده آماده نیست

Paddle در فهرست درگاه‌های پرداخت PHPTRAVELS نیست و راهنمای راه‌اندازی منتشرشده‌ای ندارد. درگاه‌های آماده که در ادامه می‌بینید همانهایی هستند که برای دریافت پرداخت رزرو ساخته شده‌اند.

درباره یکپارچه‌سازی سفارشی بپرسیددموی رزرو را امتحان کنید

  • برای پرداخت رزرو: یک درگاه آماده

    در پنل مدیریت یک درگاه آماده مثل پرداخت با Stripe یا پرداخت با PayPal را با حساب پذیرنده خودتان فعال کنید. پرداخت، بازپرداخت و مرجع رزرو از قبل در جریان رزرو وصل شده‌اند، همان‌طور که صفحه یکپارچه‌سازی درگاه پرداخت توضیح می‌دهد.

  • برای فروش نرم‌افزار: Paddle به‌صورت یکپارچه‌سازی سفارشی

    وقتی مورد استفاده شما با قوانین Paddle بخواند، توسعه‌دهندگان ما می‌توانند آن را به‌صورت یکپارچه‌سازی API سفارشی وصل کنند: پرداخت Paddle.js در صفحه شما، نقطه پایانی وب‌هوک با بررسی امضا و پرداخت‌هایی که برای مشتریان شما ثبت می‌شود. هزینه کار پیش از شروع اعلام می‌شود.

  • یا خودتان روی کد منبع بسازید

    PHPTRAVELS روی سرور خودتان میزبانی می‌شود و با کد منبع کامل ارائه می‌شود، پس توسعه‌دهندگان خودتان می‌توانند Paddle را برای اشتراک‌ها کنار موتور رزرو اضافه کنند. صفحه قیمت‌ها نشان می‌دهد هر لایسنس چه چیزی دارد.

آماده برای پرداخت رزرو

درگاه‌های پرداختی که از قبل به PHPTRAVELS وصل‌اند

برای پرداخت مسافران و ایجنت‌ها این درگاه‌ها آماده‌اند: نزد ارائه‌دهنده حساب باز می‌کنید، کلیدهایتان را در پنل مدیریت وارد می‌کنید، آزمایش می‌کنید و فعال می‌شوید. این فهرست، فهرست زنده فهرست یکپارچه‌سازی‌های ماست.

زیرایجنت‌ها هم می‌توانند از موجودی پیش‌پرداخت یا سقف اعتبار از طریق کیف پول نماینده B2B پرداخت کنند که اصلاً به درگاه نیاز ندارد.

پرسش‌های متداول

یکپارچه‌سازی Paddle API: پرسش‌های رایج

گفتگو با فروش

نه به‌صورت اتصال‌دهنده آماده. Paddle در فهرست درگاه‌های پرداخت PHPTRAVELS نیست. اگر مورد استفاده شما با قوانین Paddle بخواند، مثلاً فروش اشتراک نرم‌افزار خودتان، می‌توان آن را به‌صورت یکپارچه‌سازی سفارشی اضافه کرد یا توسعه‌دهندگان شما روی کد منبع همراه محصول بسازند.

Paddle فروشنده ثبت‌شده‌ای است که برای نرم‌افزار، SaaS و محصولات دیجیتال ساخته شده، پس معمولاً ابزار مناسبی برای پرواز، هتل یا تور نیست. پیش از استفاده از آن برای رزرو سفر، قوانین استفاده مجاز Paddle را بررسی کنید؛ بیشتر کسب‌وکارهای سفر پرداخت رزرو را از طریق درگاهی مثل Stripe، PayPal، Adyen یا یک درگاه منطقه‌ای می‌گیرند.

شرکتی که از نظر قانونی به مشتری می‌فروشد. مسئول دریافت و واریز مالیات فروش یا VAT، صدور فاکتور و رسیدگی به بازپرداخت و چارج‌بک است و در صورتحساب مشتری دیده می‌شود. در Paddle، خود Paddle این نقش را می‌گیرد و به شما پرداخت می‌کند.

درگاه پرداخت‌ها را برای شما پردازش می‌کند و شما فروشنده می‌مانید و کار مالیات و اختلاف‌ها هم با شماست. Paddle خودش فروشنده می‌شود که این کار را در فروش نرم‌افزار برمی‌دارد اما آنچه را می‌توانید از طریق آن بفروشید محدود می‌کند.

وقتی نرم‌افزار خودتان را می‌فروشید نه سفر را: ابزار رزرو، API، افزونه یا پورتال وایت‌لیبلی که آژانس‌ها اشتراکش را می‌پردازند. آن‌وقت Paddle می‌تواند آن‌ها را صورتحساب کند و مالیات هر کشور را رسیدگی کند.

Paddle رویدادهایی مثل تراکنش کامل‌شده یا اشتراک تمدیدشده را به نشانی‌ای که ثبت می‌کنید می‌فرستد. هر درخواست هدر Paddle-Signature با زمان‌نگار و هش دارد که سرور شما پیش از اقدام با کلید محرمانه نقطه پایانی بررسی می‌کند.

بله. Paddle محیط sandbox جداگانه با حساب، کلیدهای API، قیمت‌ها و کارت‌های آزمایشی خودش دارد. آنجا بسازید و آزمایش کنید، بعد پیکربندی را به محیط واقعی ببرید.

بله، به‌صورت دو جریان جدا: موتور رزرو پرداخت مسافران را از طریق درگاه آماده می‌گیرد و Paddle اشتراک‌های نرم‌افزار شما را صورتحساب می‌کند. سوابقشان را جدا نگه دارید تا هر فروش رفتار مالیاتی درست خودش را داشته باشد.

بیشتر بدانید

بیشتر درباره پلتفرم