همه راهنماها
8 دقیقه مطالعه
راهاندازی پرداخت با زرینپال
از دریافت کد sandbox تا تست کامل چرخه رزرو → پرداخت → تأیید در محیط واقعی.
راهاندازی پرداخت با زرینپال
در این راهنما، یک چرخه کامل پرداخت را از صفر تا اولین تراکنش موفق طی میکنیم.
پیشنیازها
- نوبت نصب و فعال است
- دسترسی به پنل مدیریت وردپرس دارید
- یک حساب کاربری در zarinpal.com دارید (یا میسازید)
مرحله ۱: دریافت Merchant ID از زرینپال
ثبتنام یا ورود به پنل زرینپال
به my.zarinpal.com بروید و وارد حساب خود شوید. اگر حساب ندارید، ثبتنام کنید (نیازی به تأیید هویت برای Sandbox نیست).
ساخت فروشگاه
از منوی سمت راست روی فروشگاهها کلیک کنید، سپس ایجاد فروشگاه جدید. اطلاعات خواستهشده را پر کنید.
کپی کردن Merchant ID
پس از ساخت فروشگاه، یک کد ۳۶ کاراکتری (UUID) نمایش داده میشود. این کد را کپی کنید.
مرحله ۲: پیکربندی در نوبت
رفتن به تنظیمات پرداخت
در پنل وردپرس، از منوی سمت راست به پرونوبت ← تنظیمات بروید، سپس تب پرداخت را انتخاب کنید.
انتخاب زرینپال به عنوان درگاه پیشفرض
از dropdown «درگاه پیشفرض» مقدار ZarinPal را انتخاب کنید.
وارد کردن Merchant ID
فیلد Merchant ID را با UUID کپیشده پر کنید.
تنظیم حالت Sandbox
فیلد حالت را روی sandbox بگذارید. در این حالت هیچ پولی واقعی رد و بدل نمیشود.
ذخیره تنظیمات
دکمه ذخیره را بزنید.
مرحله ۳: تست یک پرداخت کامل
باز کردن فرم رزرو
صفحهای که شورتکد [pronobat_booking] را دارد باز کنید، یا آدرس مستقیم آن را در مرورگر وارد کنید.
انجام رزرو کامل
یک سرویس انتخاب کنید، کارمند و زمان بزنید، اطلاعات مشتری را وارد کنید، و روی تأیید و پرداخت کلیک کنید.
پرداخت در صفحه زرینپال Sandbox
در صفحه Sandbox زرینپال، از اطلاعات کارت زیر استفاده کنید:
| فیلد | مقدار |
|---|---|
| شماره کارت | 6219-8610-3452-9007 |
| تاریخ انقضا | هر تاریخ آینده |
| CVV2 | هر عدد ۳ رقمی |
| رمز دوم | 123456 |
تأیید برگشت به سایت
بعد از پرداخت، باید به صفحه موفقیت بازگردانده شوید. پرونوبت بهطور خودکار تأیید پرداخت را از API زرینپال دریافت میکند.
بررسی در پنل مدیریت
در پرونوبت ← نوبتها، نوبت باید با وضعیت confirmed و پرداخت paid نمایش داده شود.
عیبیابی رایج
| مشکل | علت احتمالی | راهحل |
|---|---|---|
| صفحه پرداخت باز نمیشود | URL بازگشت ثبت نشده | آدرس callback را در پنل زرینپال بررسی کنید |
| بعد از پرداخت برنگشتم | تنظیم WP_DEBUG خطا | debug.log را بررسی کنید |
کد -10 | IP سرور block شده | IP سرور را در پنل زرینپال whitelist کنید |
برای رفتن به محیط production، کافی است فیلد حالت را از sandbox به production تغییر دهید. Merchant ID یکی است.
پرونوبت را همین الان امتحان کنید
یک نمونه کامل و زنده از افزونه با دادههای واقعی — بدون نیاز به نصب.