لوگوی پي اكسا

مرکز ابزارها، افزونه ها و مثال های اتصال

در این صفحه بسته های آماده برای اتصال به سرویس پرداخت، افزونه های کمکی و مثال های اجرایی را مثل یک ریپازیتوری مرور می کنید: فایل ها را می بینید، README را می خوانید و کل بسته را با یک دانلود می گیرید.

CONTROLLED RELEASE

انتشار کنترل شده از پنل رسمی

هر بسته از مسیر مدیریتی رسمی پی اکسا منتشر می شود و قبل از دانلود، اطلاعات کلیدی آن به صورت شفاف نمایش داده می شود.

PRE-DOWNLOAD VISIBILITY

شفافیت محتوا پیش از دریافت

پیش نمایش README، مرور ساختار فایل و نمایش متادیتای بسته کمک می کند قبل از دانلود، ارزیابی دقیق تری از محتوا داشته باشید.

TRUST PROFILE

نمای رسمی تر برای انتخاب ابزار

صفحه بر پایه شفافیت انتشار، نمایش منبع README، تاریخ بروزرسانی و آمار دانلود چیده شده تا حس ارزیابی حرفه ای تری منتقل کند.

مرجع حقوقی و هویتی کنار دسترس

ساختار صفحه طوری چیده شده که اطلاعات انتشار، محتوای فایل ها و جزئیات هر بسته بدون شلوغی اضافه در دسترس باشند.

افزونه repository / wordpress-plugin

افزونه وردپرس - ووكامرس

افزونه پرداخت براي فروشگاه ووكامرس

دانلود بسته
21 فایل payexa-gateway-for-woocommerce-1.0.10.zip README: readme.txt

دانلود ثبت شده

101

آخرین بروزرسانی

2026-09-25

حجم بسته

339.6 KB

منتشرکننده

مدیر ارشد سامانه

وضعیت نمایش

عمومی و فعال

پیش نمایش فایل

payexa-gateway/payexa-gateway.php

<?php /** * Plugin Name: Payexa Gateway for WooCommerce * Description: WooCommerce payment gateway integration for Payexa with sandbox support and transaction verification. * Version: 1.0.10 * Author: Payexa * Author URI: https://pexn.ir * License: GPLv2 or later * License URI: https://www.gnu.org/licenses/gpl-2.0.html * Requires at least: 6.4 * Requires PHP: 7.4 * Requires Plugins: woocommerce * WC requires at least: 8.0 * WC tested up to: 9.0 * Text Domain: payexa-gateway-for-woocommerce * Domain Path: /languages */ if ( ! defined( 'ABSPATH' ) ) { exit; } define( 'PAYEXA_GATEWAY_VERSION', '1.0.10' ); define( 'PAYEXA_GATEWAY_FILE', __FILE__ ); define( 'PAYEXA_GATEWAY_PATH', plugin_dir_path( __FILE__ ) ); define( 'PAYEXA_GATEWAY_URL', plugin_dir_url( __FILE__ ) ); require_once PAYEXA_GATEWAY_PATH . 'includes/class-payexa-api.php'; require_once PAYEXA_GATEWAY_PATH . 'admin/class-payexa-admin-settings.php'; require_once PAYEXA_GATEWAY_PATH . 'includes/class-payexa-plugin.php'; function payexa_gateway_bootstrap() { Payexa_Plugin::instance(); } add_action( 'plugins_loaded', 'payexa_gateway_bootstrap', 11 );

README / توضیحات

منبع: readme.txt

=== Payexa Gateway for WooCommerce | درگاه پرداخت پی اکسا برای ووکامرس === Contributors: payexa Tags: payment, gateway, payexa, pexn, woocommerce, iran payment, درگاه پرداخت, پی‌اکسا, پرداخت آنلاین, ووکامرس Requires at least: 6.4 Tested up to: 6.8 Requires PHP: 7.4 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html WC requires at least: 8.0 WC tested up to: 9.0

افزونه حرفه ای درگاه پرداخت Payexa برای WooCommerce با رابط فارسی RTL، تایید تراکنش، حالت سندباکس و بازگشت استاندارد به صفحات خود ووکامرس. Professional Payexa payment gateway for WooCommerce with Persian RTL UX, PAYEXA sandbox token support, transaction verification, and standard WooCommerce order flow.

== Description ==

Payexa Gateway for WooCommerce یک افزونه حرفه ای برای اتصال فروشگاه وردپرسی شما به درگاه پرداخت پی اکسا است. این افزونه برای فروشگاه های فارسی زبان، کسب وکارهای ایرانی و توسعه دهندگانی طراحی شده است که به یک درگاه پرداخت WooCommerce سبک، پایدار، امن و آماده انتشار نیاز دارند.

Payexa Gateway for WooCommerce provides a production-grade payment gateway integration for merchants who need a reliable Payexa, PEXN, and Iran payment solution inside WooCommerce. The plugin includes sandbox support, callback verification, structured logging, RTL Persian UI, and a clean checkout experience.

Features and SEO keywords:

  • درگاه پرداخت پی اکسا برای ووکامرس
  • اتصال مستقیم به Payexa API
  • پشتیبانی از محیط عملیاتی و سندباکس با توکن PAYEXA
  • تایید تراکنش از طریق callback و verify
  • رابط کاربری فارسی و RTL در مدیریت و فرانت
  • ثبت لاگ با WooCommerce Logger
  • بازگشت استاندارد به صفحه سفارش و پرداخت ووکامرس
  • سازگار با WooCommerce و WordPress جدید
  • Ideal for payment, gateway, payexa, pexn, woocommerce, iran payment, checkout, Persian ecommerce

Why this WooCommerce Payexa plugin matters:

  • سبک و بهینه است و فقط در صفحات مورد نیاز asset لود می کند.
  • برای بازار ایران و سناریوهای درگاه پرداخت فارسی طراحی شده است.
  • ساختار توسعه پذیر برای سفارشی سازی و نگهداری بلندمدت دارد.
  • تجربه پرداخت کاربر را با پیام اعتماد، رابط RTL و بازگشت شفاف سفارش بهبود می دهد.

Plugin capabilities:

  • Payment request via /v1/payment/request
  • Sends official Content-Type: application/json and X-API-KEY headers
  • Payment verify via /v1/payment/verify
  • Redirects shoppers to /startPay?authority={authority}
  • Dedicated WooCommerce callback endpoint with wc-api=payexa_callback
  • Uses WooCommerce order-received page for successful payments
  • Returns failed or canceled payments to the WooCommerce payment page
  • Sandbox access by entering PAYEXA in the API key field
  • Production token support from https://pexn.ir
  • Persian admin configuration panel with Test Connection button
  • Finalizes WooCommerce orders only after verify HTTP 200 SUCCESS
  • Detects duplicate verify HTTP 201 and avoids double finalization

== Third-Party Services ==

This plugin connects to the external Payexa payment service to create and verify payment transactions.

It sends the following data to Payexa when a customer starts payment:

  • Order amount
  • Callback URL
  • A unique merchant-side order reference

It sends the following data to Payexa when verifying a payment:

  • Payexa request order ID returned by the payment request API
  • The unique verification token returned by Payexa as amount_unique

The service endpoints used by the plugin are:

  • https://pay.pexn.ir/v1/payment/request
  • https://pay.pexn.ir/v1/payment/verify
  • https://sandbox.pexn.ir/v1/payment/request
  • https://sandbox.pexn.ir/v1/payment/verify

Merchant API keys are stored in WordPress and sent server-to-server in the X-API-KEY header.

Please review the provider terms and policies before using the service:

  • https://pexn.ir

== Installation ==

  1. پوشه payexa-gateway را در مسیر /wp-content/plugins/ قرار دهید.
  2. افزونه را از بخش افزونه های وردپرس فعال کنید.
  3. مطمئن شوید WooCommerce نصب و فعال است.
  4. از منوی WooCommerce > درگاه پی اکسا وارد تنظیمات شوید.
  5. برای استفاده از سندباکس، در فیلد API Key مقدار PAYEXA را وارد کنید.
  6. برای استفاده در محیط واقعی، در https://pexn.ir ثبت نام کنید و API Key خود را وارد کنید.
  7. درگاه پرداخت Payexa را در تسویه حساب WooCommerce فعال کنید و یک سفارش تست ثبت کنید.

== Frequently Asked Questions ==

= آیا افزونه از سندباکس پشتیبانی می کند؟ = بله. برای استفاده از سندباکس کافی است در فیلد API Key مقدار PAYEXA را وارد کنید تا افزونه به صورت خودکار از آدرس sandbox و توکن ثابت PAYEXA استفاده کند.

= برای محیط واقعی چه چیزی لازم است؟ = باید در pexn.ir ثبت نام کنید و API token اختصاصی خود را در تنظیمات افزونه وارد کنید.

= آیا این افزونه برای ووکامرس فارسی مناسب است؟ = بله. رابط مدیریت، پیام های کاربری و چیدمان checkout به صورت فارسی و RTL طراحی شده است.

= آیا لاگ ثبت می شود؟ = بله. این افزونه از WooCommerce Logger برای ثبت درخواست، پاسخ و خطاهای ارتباطی استفاده می کند.

= هدرهای رسمی API چگونه ارسال می شوند؟ = افزونه درخواست های سروری Payexa را با هدرهای Content-Type: application/json و X-API-KEY ارسال می کند. کلید API فقط در سمت سرور وردپرس نگهداری می شود.

= سفارش دقیقا چه زمانی موفق می شود؟ = فقط وقتی verify پی اکسا با HTTP 200 و status برابر SUCCESS برگردد، سفارش نهایی می شود. اگر verify کد 201 برگرداند، یعنی قبلا تایید شده و افزونه از ثبت موفقیت تکراری جلوگیری می کند.

== Screenshots ==

  1. صفحه تنظیمات فارسی درگاه Payexa در مدیریت ووکامرس
  2. نمایش درگاه پرداخت پی اکسا در checkout ووکامرس
  3. بازگشت موفق به صفحه استاندارد سفارش ووکامرس پس از verify
  4. بازگشت ناموفق یا لغو پرداخت به صفحه پرداخت ووکامرس

== Changelog ==

= 1.0.0 = * انتشار اولیه افزونه درگاه پرداخت Payexa برای WooCommerce * افزودن request، verify و callback حرفه ای * افزودن پنل تنظیمات فارسی RTL * استفاده از بازگشت استاندارد WooCommerce برای حالت موفق و ناموفق * افزودن readme دو زبانه با تمرکز بر سئو کلمات کلیدی payment gateway, Payexa, PEXN, WooCommerce, درگاه پرداخت

== Upgrade Notice ==

= 1.0.0 = اولین نسخه پایدار افزونه Payexa Gateway for WooCommerce منتشر شد.

PAYEXA ASSISTANT

من دستیار پی اکسا هستم، شما را در تمام مسیر راهنمایی می‌کنم و اگر به من نیازی ندارید با ۲ بار کلیک خاموش می‌شوم.