manifest / ecommerce / mrn-wp-ir-payment

MRN پرداخت ایران

Iranian payment gateways

by MRN · github.com/mehran-mrn/mrn-wp-ir-payment · website

★ 0stars

0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/mehran-mrn/mrn-wp-ir-payment/archive/refs/heads/main.zip

Readme github.com/mehran-mrn/mrn-wp-ir-payment ↗

افزونه مستقل و حرفه‌ای پرداخت آنلاین و اقساطی ایران برای WooCommerce.

امکانات

یک تجربه یکپارچه در Checkout و انتخاب سرویس توسط خریدار
سازگار با Checkout کلاسیک، Checkout Blocks و HPOS
کاتالوگ کامل ۴۷ درگاه نمونه، به‌علاوه دو اتصال سفارشی سازمانی و اقساطی
اتصال داخلی برای ۱۷ سرویس دارای پروتکل عملی: زرین‌پال، زیبال، وندار، پی‌پینگ، سپال، آقای پرداخت، آسان پرداخت، بیت‌پی، دایرکت‌پی، جیبیت، نابیک‌پی، نئوگیت، پاسارگاد، پی‌استار، سامان، شپا و سیزپی
پروفایل API آماده برای IDPay و NextPay
موتور قرارداد REST/فرم برای بانک‌ها و سرویس‌های BNPL دارای مستندات خصوصی پذیرندگان
تبدیل امن واحدهای ریال، تومان، صد ریال و هزار تومان
بازگشت امضاشده و تأیید idempotent
وضعیت unknown برای خطای شبکه هنگام verify؛ سفارش در این حالت از دست نمی‌رود
ثبت دفتر تراکنش و رویدادهای ماسک‌شده
رمزنگاری credentialها با Sodium یا AES-256-GCM
داشبورد RTL، فیلتر تراکنش، خروجی CSV و بررسی سلامت
نگه‌داری داده مالی هنگام uninstall مگر با opt-in صریح

پیش‌نیاز

WordPress 6.4+
PHP 7.4+
WooCommerce 8.0+
ارز فروشگاه یکی از IRT، IRR، IRHR یا IRHT

نصب

پوشه mrn-ir-payment را در wp-content/plugins قرار دهید، افزونه را فعال کنید و از منوی «MRN پرداخت» اطلاعات پذیرنده را وارد کنید. سپس در ووکامرس ← پیکربندی ← پرداخت‌ها روش «MRN پرداخت ایران» را فعال نگه دارید.

اتصال سرویس اقساطی یا سازمانی

در کارت هر سرویس قراردادی یا در کارت‌های سفارشی این موارد را وارد کنید:

URL ایجاد و تأیید پرداخت
هدرهای احراز هویت به‌شکل JSON
قالب درخواست و verify و نوع ارسال JSON یا Form
مسیر dot-notation توکن، وضعیت موفق و کد مرجع در پاسخ
الگوی انتقال مانند https://partner.example/pay/{{authority}}

متغیرهای قالب:

متغیر	توضیح
`{{transaction_id}}`	UUID عمومی تراکنش
`{{order_id}}`	شناسه سفارش
`{{amount_toman}}`	مبلغ صحیح به تومان
`{{amount_rial}}`	مبلغ صحیح به ریال
`{{callback_url}}`	نشانی بازگشت امضاشده
`{{mobile}}`	موبایل صورتحساب
`{{email}}`	ایمیل صورتحساب
`{{authority}}`	توکن ایجادشده؛ مخصوص verify و redirect
`{{callback.FIELD}}`	مقدار برگشتی سرویس در query/body
`{{config.FIELD}}`	مقدار credential رمزگشایی‌شده همان سرویس

نمونه request:

{
  "amount": "{{amount_rial}}",
  "orderId": "{{order_id}}",
  "callbackUrl": "{{callback_url}}",
  "mobile": "{{mobile}}"
}

توسعه درگاه اختصاصی

mrn_ir_payment_provider_definitions: افزودن یا تغییر metadata و فیلدهای سرویس
mrn_ir_payment_gateway_instance: جایگزینی instance آداپتور
mrn_ir_payment_paid: پس از تأیید قطعی
mrn_ir_payment_failed: پس از رد قطعی

آداپتور PHP باید MRN\IranPayment\Contracts\GatewayInterface را پیاده‌سازی کند.

سیاست داده

Uninstall به‌طور پیش‌فرض جدول تراکنش‌ها را حذف نمی‌کند. برای حذف صریح همه داده‌ها، پیش از uninstall ثابت زیر را در wp-config.php تعریف کنید:

define( 'MRN_IR_PAYMENT_REMOVE_DATA', true );

مجوز

GPL-2.0-or-later