درگاه پرداخت
درگاه پرداخت
مسیر: پرونوبت ← تنظیمات ← پرداخت
درگاه پیشفرض
فقط یک درگاه میتواند فعال باشد. برای آزمایش، زرینپال در حالت Sandbox پیشنهاد میشود.
زرینپال
| فیلد | توضیح |
|---|---|
| merchant_id | شناسه ۳۶ کاراکتری از پنل زرینپال |
| حالت | sandbox یا production |
| آدرس بازگشت | پر میشود از {siteurl}/wp-json/pronobat/v1/payments/verify |
در حالت Sandbox از merchant_id = XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX (مقدار نمونه در مستندات زرینپال) استفاده کنید.
آیدیپی
| فیلد | توضیح |
|---|---|
| api_key | کلید API از پنل آیدیپی |
| حالت | sandbox یا production |
آیدیپی از استرداد وجه (refund) پشتیبانی میکند. درخواست استرداد از پرونوبت ← نوبتها ← جزئیات ارسال میشود.
نکستپی
| فیلد | توضیح |
|---|---|
| api_token | توکن API از پنل نکستپی (کلید payments.nextpay.api_token) |
نکستپی استرداد خودکار ندارد. هنگام درخواست استرداد، endpoint با کد خطای pronobat_refund_manual (HTTP 422) پاسخ میدهد و مدیر باید استرداد را از پنل نکستپی انجام داده و وضعیت را دستی تغییر دهد. (این یک کد خطا است، نه یک هوک.)
امنیت پرداخت
تمام تأییدیهها سرور به سرور انجام میشوند:
// src/Gateways/ZarinpalGateway.php
public function verify( string $authority, int $amount ): PaymentVerifyResult {
$response = wp_remote_post( 'https://api.zarinpal.com/pg/v4/payment/verify.json', [
'body' => json_encode([
'merchant_id' => $this->merchant_id,
'authority' => sanitize_text_field( $authority ),
'amount' => $amount,
]),
] );
// ...
}هیچگاه مقدار amount از سمت کلاینت پذیرفته نمیشود؛ مقدار واقعی از پایگاه داده خوانده میشود.
لاگ تراکنشها
همه تراکنشها در جدول wp_pronobat_payments ذخیره میشوند:
| ستون | نوع | توضیح |
|---|---|---|
| id | INT | شناسه یکتا |
| appointment_id | INT | FK به جدول نوبتها |
| gateway | VARCHAR(30) | نام درگاه |
| amount | INT | مبلغ به ریال |
| status | ENUM | pending / paid / refunded / failed |
| ref_id | VARCHAR(100) | شماره مرجع از درگاه |
| created_at | DATETIME | زمان UTC |
حالت پرداخت و ووکامرس
علاوه بر درگاههای داخلی، پرونوبت از پرداخت ترکیبی پشتیبانی میکند. با تنظیم «حالت پرداخت» (خودکار / درگاه داخلی / ووکامرس) میتوانید پرداخت را از طریق سفارش مجازی ووکامرس انجام دهید و از همهی درگاههای ووکامرس استفاده کنید. جزئیات در پرداخت با ووکامرس.
پیشپرداخت (بیعانه)
میتوانید بخشی از مبلغ را بهصورت آنلاین دریافت و باقیمانده را در محل بگیرید. جزئیات در پیشپرداخت / بیعانه.
پرونوبت را همین الان امتحان کنید
یک نمونه کامل و زنده از افزونه با دادههای واقعی — بدون نیاز به نصب.