زرینپال
یکپارچهسازی زرینپال
پیشنیازها
- حساب کاربری در zarinpal.com
- کد Merchant از بخش «فروشگاهها»
پیکربندی در نوبت
مسیر: پرونوبت ← تنظیمات ← پرداخت ← زرینپال
| فیلد | توضیح |
|---|---|
| Merchant ID | کد ۳۶ کاراکتری |
| حالت | sandbox برای آزمایش، production برای واقعی |
| آدرس بازگشت | بهطور خودکار پر میشود |
حالت Sandbox
در حالت Sandbox:
- Merchant ID میتواند هر مقداری باشد
- پرداخت واقعی انجام نمیشود
- برای آزمایش از کارت شماره
6219861034529007استفاده کنید
URL بازگشت
پرونوبت هنگام ایجاد تراکنش، آدرس بازگشت (Callback) زیر را به درگاه میفرستد:
https://example.com/wp-json/pronobat/v1/public/payment/verify
این endpoint پس از تأیید سمت سرور، کاربر را به صفحهی /booking/success یا /booking/failed هدایت میکند. اگر پنل زرینپال نیاز به ثبت دامنه/آدرس بازگشت دارد، همین آدرس را ثبت کنید.
خطاهای رایج
| کد خطا | علت | راهحل |
|---|---|---|
-9 | اعتبارسنجی ناقص | Merchant ID را بررسی کنید |
-10 | IP غیرمجاز | IP سرور را در پنل زرینپال whitelist کنید |
-21 | هیچ تراکنش مالی پیدا نشد | کاربر از درگاه برنگشته یا Authority منقضی شده |
-22 | تراکنش ناموفق | کاربر پرداخت را لغو کرده |
100 | موفق | — |
101 | قبلاً تأیید شده | نوبت از قبل پرداخت شده (نادیده بگیرید) |
در صورت دریافت کد 101، نوبت را تأییدشده فرض کنید. این حالت زمانی اتفاق میافتد که کاربر صفحه موفقیت را رفرش کرده باشد.
پرونوبت را همین الان امتحان کنید
یک نمونه کامل و زنده از افزونه با دادههای واقعی — بدون نیاز به نصب.