یکپارچهسازی Paddle
Paddle یک پلتفرم پرداخت است که بهعنوان فروشنده ثبتشده برای فروش محصولات دیجیتال شما عمل میکند. یعنی Paddle محاسبه و پرداخت مالیات جهانی (VAT، GST، مالیات فروش) را از طرف شما مدیریت میکند؛ در نتیجه کسبوکار شما بدون نیاز به هیچ پیکربندی، بهطور کامل با الزامات مالیاتی جهانی مطابقت دارد.
چه زمانی بهجای Stripe از Paddle استفاده کنید
- محصولات دیجیتال خود را به مشتریان سراسر جهان میفروشید و به رعایت خودکار الزامات مالیاتی جهانی نیاز دارید
- میخواهید در هر کشوری که به آن فروش دارید، مجوز VAT/GST ثبت نکنید
- میخواهید Paddle اختلافات پرداخت را از طرف شما مدیریت کند
راهاندازی
- در paddle.com حساب Paddle ایجاد کنید و تأیید کسبوکار خود را تکمیل کنید
- در dashboard پaddle به Developer Tools → Authentication بروید و اطلاعات ورود API ایجاد کنید
- شناسه فروشنده خود را یادداشت کنید: Vendor ID، کلید APIو Secret وبهوک
- در پنل مدیریت، به مسیر زیر بروید Settings → Payment Gateways → Paddle
- Vendor ID، کلید API و Secret وبهوک خود را وارد کنید
- محیط را تنظیم کنید: Sandbox برای آزمایش، Production برای محیط عملیاتی
- تنظیم شود به Active
Webhooks
آدرس URL وبهوک Paddle را در داشبورد Paddle، در مسیر زیر پیکربندی کنید: Developer Tools → Notifications:
https://your-store.com/api/payment/webhooks/paddle
به موارد زیر مشترک شوید: payment_succeeded، payment_refunded، subscription_created, subscription_cancelled, subscription_payment_succeeded, subscription_payment_failed.
صورتحساب اشتراک با Paddle
Paddle بهصورت بومی صورتحساب اشتراک را مدیریت میکند؛ از جمله تلاش مجدد در پرداختهای ناموفق و محاسبه نسبی وقتی مشتریان پلنهای خود را ارتقا یا تنزل میدهند. تغییرات وضعیت اشتراک از طریق webhook با فروشگاه شما همگامسازی میشود.
رسیدهای مالیاتی
Paddle رسیدهای مالیاتی را بهصورت خودکار تولید میکند و آنها را برای مشتریان ایمیل میکند. نیازی به صدور جداگانه فاکتور مالیاتی برای سفارشهای Paddle ندارید — Paddle فروشنده رسمی است.

