راهنمای جامع راهاندازی درگاه پرداخت اقساطی اسنپپی (SnappPay BNPL) در فروشگاههای وبیتو
امروزه مدل پرداخت «الان بخر، بعداً پرداخت کن» (Buy Now, Pay Later یا به اختصار BNPL) به یکی از قدرتمندترین ابزارهای رشد فروش در تجارت الکترونیک جهان و ایران تبدیل شده است. در ایران، اسنپپی (SnappPay) وابسته به گروه اسنپ، پیشگام و بازیگر شماره یک این حوزه است که به خریداران اجازه میدهد هزینه سبد خرید خود را در ۴ قسط ماهانه مساوی، بدون نیاز به ارائه چک، ضامن، سفته یا کارمزد اضافی پرداخت کنند.
نکته کلیدی برای فروشگاهداران این است که اسنپپی کل مبلغ سفارش را به صورت نقد و یکجا طبق سیکل پایا با فروشگاه تسویه میکند و ریسک وصول اقساط از مشتری بهطور کامل بر عهده اسنپپی است.
در این مقاله، آموزش گامبهگام دریافت درگاه اسنپپی، نحوه اتصال به پلاگین رسمی وبیتو، فرآیند تسویه دو مرحلهای (Two-Phase Settle)، کارمزدها و رفع خطاهای احتمالی را به تفصیل بررسی میکنیم.
۱. چرا فعالسازی اسنپپی برای فروشگاههای آنلاین حیاتی است؟
آمارهای تجاری فروشگاههای آنلاین نشان میدهد که اضافه شدن اسنپپی تأثیرات شگفتانگیزی بر شاخصهای کلیدی عملکرد (KPI) دارد:
| شاخص عملکردی (KPI) | تاثیر اسنپپی در فروشگاه | دلیل بهبود |
|---|---|---|
| نرخ تبدیل سبد خرید (Conversion Rate) | ۳۵٪ تا ۵۵٪ افزایش | خریدار در لحظه تنها ۲۵٪ مبلغ را میپردازد و حس گرانی کالا خنثی میشود. |
| میانگین ارزش سفارش (AOV) | ۴۰٪ تا ۷۰٪ افزایش | کاربران تمایل پیدا میکنند اقلام جانبی و محصولات گرانتر را به سبد خرید بیفزایند. |
| ریسک عدم پرداخت مشتری (Default Risk) | صفر درصد برای فروشنده | مسئولیت پیگیری و دریافت اقساط ۱۰۰٪ با اسنپپی است. |
| جذب مشتریان جدید (Acquisition) | دسترسی به ۱۰+ میلیون کاربر فعال | کاربران سوپراپ اسنپ تمایل بالایی به خرید از سایتهای پذیرنده اسنپپی دارند. |
۲. مدارک و مراحل ثبتنام پذیرندگان در اسنپپی
برای دریافت درگاه سازمانی اسنپپی، باید مراحل زیر را طی نمایید:
- ارسال درخواست اولیه:
- مراجعه به وبسایت رسمی اسنپپی بخش پذیرندگان (
snapppay.ir) یا ارسال ایمیل درخواست به[email protected]. - همچنین میتوانید با مرکز تماس پذیرندگان اسنپپی به شماره ۰۲۱-۹۶۸۶۲۲۲۲ تماس حاصل فرمایید.
- مراجعه به وبسایت رسمی اسنپپی بخش پذیرندگان (
- ارائه مدارک کسبوکار:
- اشخاص حقوقی: آگهی تاسیس، آخرین تغییرات روزنامه رسمی، کد اقتصادی، شناسه ملی، تصویر شناسنامه و کارت ملی دارندگان حق امضا، گواهی اینماد فعال و شماره شبای حساب بانکی به نام شرکت.
- اشخاص حقیقی: تصویر مدارک هویتی (کارت ملی و شناسنامه)، اینماد فعال فروشگاه، جواز کسب یا پروانه فعالیت، و شماره شبای بانکی منطبق با کد ملی متقاضی.
- امضای قرارداد و دریافت دسترسیها:
- پس از بررسی مدارک و امضای قرارداد محرمانه و پذیرندگی، فایل تنظیمات شامل Client ID، Client Secret، Username و Password از طریق پرتال
portal.snapppay.irدر اختیار شما قرار میگیرد.
- پس از بررسی مدارک و امضای قرارداد محرمانه و پذیرندگی، فایل تنظیمات شامل Client ID، Client Secret، Username و Password از طریق پرتال
۳. جدول پارامترهای فنی در پنل وبیتو
پس از دریافت دسترسی، وارد پنل وبیتو > پلاگینها و ادغامها > درگاههای پرداخت > SnappPay شوید و مقادیر را تکمیل کنید:
| نام پارامتر در وبیتو | عنوان در مستندات اسنپپی | الزامی؟ | توضیحات و راهنما | نمونه مقدار |
|---|---|---|---|---|
| Client ID | client_id | بله | شناسه کلاینت اختصاصی فروشگاه در سامانه OAuth2 اسنپپی | webito_merchant_live_01 |
| Client Secret | client_secret | بله (محرمانه) | کلید امنیتی برای تولید توکن دسترسی | sec_snapp_8899aabbccddee |
| Username | username | بله | نام کاربری پنل پذیرندگی برای احراز هویت | merchant_shop_user |
| Password | password | بله (محرمانه) | گذرواژه امن وبسرویس | P@ssw0rd!Snapp2026 |
| Sandbox Mode | محیط تست | خیر | هدایت درخواستها به سرور تستی staging-api.snapppay.ir | true / false |
۴. کالبدشکافی چرخه تراکنش و تسویه دو مرحلهای (Two-Phase Settle)
یکی از مهمترین تمایزهای معماری اسنپپی با درگاههای شتابی معمولی، الزام به اجرای فرآیند تسویه دو مرحلهای (Two-Phase Settle) است. وبیتو این چرخه را به صورت کاملاً خودکار و تضمینشده مدیریت میکند:
mermaidsequenceDiagram autonumber actor خریدار as کاربر / خریدار participant وبیتو as فروشگاه وبیتو participant اسنپ_پی as سرور اسنپپی (OAuth2 / Payment) وبیتو->>اسنپ_پی: ۱. دریافت توکن دسترسی Bearer (/oauth/token) خریدار->>وبیتو: ۲. انتخاب پرداخت اقساطی اسنپپی وبیتو->>اسنپ_پی: ۳. ایجاد تراکنش و دریافت توکن پرداخت (/payment/v1/token) وبیتو-->>خریدار: ۴. هدایت به درگاه پرداخت اسنپپی (payment.snapppay.ir) خریدار->>اسنپ_پی: ۵. پرداخت قسط اول (۲۵٪) با رمز پویا اسنپ_پی-->>وبیتو: ۶. بازگشت به Callback فروشگاه همراه با Payment Token وبیتو->>اسنپ_پی: ۷. استعلام وضعیت تراکنش (/payment/v1/verify) اسنپ_پی-->>وبیتو: ۸. تایید اعتبار تراکنش (Status: SUCCESS) وبیتو->>اسنپ_پی: ۹. تسویه قطعی و کسر اعتبار (/payment/v1/settle) اسنپ_پی-->>وبیتو: ۱۰. تایید قطعی ثبت سفارش و تسویه (Settle Response: 200 OK) وبیتو-->>خریدار: ۱۱. نمایش صفحه فاکتور و تایید نهایی سفارش
[!CAUTION] نکته حیاتی درباره مرحله Settle
اگر وبسرویس فروشگاه پس از متد verify اقدام به فراخوانی متد settle نکند، اسنپپی فرض میکند سفارش در فروشگاه نهایی نشده و پس از ۳۰ دقیقه تراکنش را لغو (Revert) کرده و قسط کسرشده را به کیفپول کاربر بازمیگرداند. پلاگین وبیتو متد Settle را بلافاصله پس از Verify فراخوانی میکند تا هیچ سفارشی معلق نماند.
۵. جدول عیبیابی و کدهای خطای رایج اسنپپی
در صورت بروز هرگونه اختلال در فرآیند پرداخت، جدول زیر راهنمای حل سریع مشکل است:
| کد وضعیت HTTP | پیام خطا / وضعیت | علت بروز خطا | راهکار و نحوه رفع |
|---|---|---|---|
| 401 | Unauthorized / Invalid Client | مقدار Client ID یا Client Secret اشتباه است | تنظیمات را از پرتال اسنپپی مجدداً کپی و در وبیتو ثبت کنید. |
| 403 | IP Not Whitelisted | آیپی سرور فروشگاه در اسنپپی ثبت نشده است | با پشتیبانی اسنپپی مکاتبه کرده و آیپی ثابت سرور خود را اعلام نمایید. |
| 400 | User Not Eligible | کاربر حد اعتبار کافی برای خرید اقساطی ندارد | خریدار باید در اپلیکیشن اسنپ اعتبار اقساطی خود را افزایش دهد. |
| 409 | Duplicate Transaction / Token Expired | انقضای توکن پرداخت یا تلاش برای پرداخت مجدد | مشتری باید مجدداً فرآیند پرداخت را از سبد خرید آغاز کند. |
| 504 | Gateway Timeout | کندی موقت درگاه ارتباطی با بانکها | وبیتو با سیستم Retry اتوماتیک استعلام را مجدداً ارسال میکند. |
۶. پرسشهای متداول (FAQ)
س: کارمزد اسنپپی برای فروشگاهها چقدر است؟
ج: کارمزد اسنپپی بسته به صنف فعالیت، حجم فروش ماهانه و نوع قرارداد بین ۲ تا ۵ درصد متغیر است که در قرارداد پذیرندگی قید میگردد. برای خریدار هیچگونه سود یا بهرهای محاسبه نمیشود.
س: تسویه وجوه با فروشگاه در چه زمانی انجام میشود؟
ج: اسنپپی کل مبلغ سفارش (منهای کارمزد قرارداد) را در روزهای کاری طبق سیکل پایا (معمولاً ۲۴ تا ۴۸ ساعت بعد از ثبت نهایی فاکتور) به شماره شبای رسمی شرکت واریز مینماید.
س: اگر مشتری سفارش را مرجوع کند، بازگشت وجه به چه صورت است؟
ج: از طریق پنل مدیریت وبیتو، با کلیک بر روی دکمه «استرداد وجه»، وبیتو اندپوینت /revert اسنپپی را صدا میزند. اقساط کسرشده فوراً به کیفپول اسنپپی مشتری عودت داده شده و اقساط بعدی او لغو میگردد.