{"id":307346,"date":"2026-05-08T19:25:08","date_gmt":"2026-05-08T19:25:08","guid":{"rendered":"https:\/\/fa.wordpress.org\/plugins\/payexa-gateway-for-woocommerce\/"},"modified":"2026-05-08T19:24:42","modified_gmt":"2026-05-08T19:24:42","slug":"payexa-gateway-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/payexa-gateway-for-woocommerce\/","author":23491768,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"6.9.4","requires":"6.4","requires_php":"7.4","requires_plugins":null,"header_name":"Payexa Gateway for WooCommerce","header_author":"Payexa","header_description":"WooCommerce payment gateway integration for Payexa with sandbox support and transaction verification.","assets_banners_color":"566ea9","last_updated":"2026-05-08 19:24:42","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/pexn.ir","rating":0,"author_block_rating":0,"active_installs":0,"downloads":30,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"payexa","date":"2026-05-08 19:24:42"}},"upgrade_notice":{"1.0.0":"<p>Initial stable release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3526811,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3526811,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3526811,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3526811,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-4.png":{"filename":"screenshot-4.png","revision":3526812,"resolution":"4","location":"plugin"},"screenshot-1.png":{"filename":"screenshot-1.png","revision":3526812,"resolution":"1","location":"plugin"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3526812,"resolution":"2","location":"plugin"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3526812,"resolution":"3","location":"plugin"}},"screenshots":{"1":"Payexa gateway settings page in WooCommerce admin","2":"Payexa payment method during WooCommerce checkout","3":"Successful return to the WooCommerce order received page after verification","4":"Failed or canceled payment return flow"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1890,262365,507,262366,286],"plugin_category":[45],"plugin_contributors":[262367],"plugin_business_model":[],"class_list":["post-307346","plugin","type-plugin","status-publish","hentry","plugin_tags-gateway","plugin_tags-payexa","plugin_tags-payment","plugin_tags-pexn","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-payexa","plugin_committers-payexa"],"banners":{"banner":"https:\/\/ps.w.org\/payexa-gateway-for-woocommerce\/assets\/banner-772x250.png?rev=3526811","banner_2x":"https:\/\/ps.w.org\/payexa-gateway-for-woocommerce\/assets\/banner-1544x500.png?rev=3526811","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/payexa-gateway-for-woocommerce\/assets\/icon-128x128.png?rev=3526811","icon_2x":"https:\/\/ps.w.org\/payexa-gateway-for-woocommerce\/assets\/icon-256x256.png?rev=3526811","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/payexa-gateway-for-woocommerce\/trunk\/screenshot-1.png?rev=3526812","caption":"Payexa gateway settings page in WooCommerce admin"},{"src":"https:\/\/ps.w.org\/payexa-gateway-for-woocommerce\/trunk\/screenshot-2.png?rev=3526812","caption":"Payexa payment method during WooCommerce checkout"},{"src":"https:\/\/ps.w.org\/payexa-gateway-for-woocommerce\/trunk\/screenshot-3.png?rev=3526812","caption":"Successful return to the WooCommerce order received page after verification"},{"src":"https:\/\/ps.w.org\/payexa-gateway-for-woocommerce\/trunk\/screenshot-4.png?rev=3526812","caption":"Failed or canceled payment return flow"}],"raw_content":"<!--section=description-->\n<p>Payexa Gateway for WooCommerce connects a WooCommerce store to the Payexa payment service. It lets merchants send customers to Payexa for payment, verify completed transactions, and update WooCommerce orders based on the verification result.<\/p>\n\n<p>The plugin includes sandbox support, callback verification, WooCommerce logging, block checkout support, and a Persian RTL presentation for merchants who operate Persian-language stores.<\/p>\n\n<p>Features:<\/p>\n\n<ul>\n<li>Sends payment requests to Payexa and redirects the customer to the hosted payment page.<\/li>\n<li>Verifies the transaction before marking the WooCommerce order as paid.<\/li>\n<li>Supports the Payexa sandbox when the API key field contains <code>PAYEXA<\/code>.<\/li>\n<li>Stores transaction details in WooCommerce order meta for support and reconciliation.<\/li>\n<li>Adds frontend checkout assets only on checkout and order received pages.<\/li>\n<li>Supports the classic WooCommerce checkout and the WooCommerce blocks checkout.<\/li>\n<li>Provides a Persian RTL interface for checkout and plugin settings.<\/li>\n<\/ul>\n\n<p>How it works:<\/p>\n\n<ul>\n<li>The plugin creates a payment request through the Payexa API.<\/li>\n<li>The customer is redirected to Payexa to complete payment.<\/li>\n<li>Payexa returns the customer to WooCommerce through the callback endpoint.<\/li>\n<li>The plugin verifies the transaction with Payexa and updates the order status.<\/li>\n<\/ul>\n\n<p>Requirements:<\/p>\n\n<ul>\n<li>WordPress 6.4 or newer<\/li>\n<li>WooCommerce 8.0 or newer<\/li>\n<li>A Payexa merchant account and API key for live payments<\/li>\n<\/ul>\n\n<h3>Third-Party Services<\/h3>\n\n<p>This plugin connects to the external Payexa payment service to create and verify payment transactions.<\/p>\n\n<p>What the service is used for:<\/p>\n\n<ul>\n<li>Creating payment requests for WooCommerce orders<\/li>\n<li>Redirecting the customer to the Payexa hosted payment page<\/li>\n<li>Verifying completed transactions before the order is marked as paid<\/li>\n<\/ul>\n\n<p>What data is sent when a customer starts payment:<\/p>\n\n<ul>\n<li>Order amount<\/li>\n<li>Callback URL<\/li>\n<li>A unique merchant-side order reference<\/li>\n<\/ul>\n\n<p>What data is sent when the plugin verifies a payment:<\/p>\n\n<ul>\n<li>Payexa request order ID returned by the payment request API<\/li>\n<li>The unique verification token returned by Payexa as amount_unique<\/li>\n<\/ul>\n\n<p>When data is sent:<\/p>\n\n<ul>\n<li>A payment request is sent when the customer places an order and chooses this gateway.<\/li>\n<li>A verification request is sent after Payexa returns the customer to the WooCommerce callback URL.<\/li>\n<\/ul>\n\n<p>Service endpoints used by the plugin:<\/p>\n\n<ul>\n<li>https:\/\/pay.pexn.ir\/v1\/payment\/request<\/li>\n<li>https:\/\/pay.pexn.ir\/v1\/payment\/verify<\/li>\n<li>https:\/\/sandbox.pexn.ir\/v1\/payment\/request<\/li>\n<li>https:\/\/sandbox.pexn.ir\/v1\/payment\/verify<\/li>\n<\/ul>\n\n<p>Merchant API keys are stored in WordPress and sent server-to-server in the X-API-KEY header.<\/p>\n\n<p>Provider policies:<\/p>\n\n<ul>\n<li>Terms of service: https:\/\/pexn.ir\/terms<\/li>\n<li>Privacy policy: https:\/\/pexn.ir\/privacy<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>payexa-gateway<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the plugin from the WordPress admin area.<\/li>\n<li>Make sure WooCommerce is installed and active.<\/li>\n<li>Go to WooCommerce &gt; \u062f\u0631\u06af\u0627\u0647 \u067e\u06cc \u0627\u06a9\u0633\u0627.<\/li>\n<li>Enter your live Payexa API key in the API Key field.<\/li>\n<li>To use the sandbox, enter <code>PAYEXA<\/code> in the API Key field.<\/li>\n<li>Enable the gateway and place a test order.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20plugin%20support%20the%20payexa%20sandbox%3F\"><h3>Does this plugin support the Payexa sandbox?<\/h3><\/dt>\n<dd><p>Yes. Enter <code>PAYEXA<\/code> in the API Key field and the plugin will use the sandbox API endpoints automatically.<\/p><\/dd>\n<dt id=\"what%20do%20i%20need%20for%20live%20payments%3F\"><h3>What do I need for live payments?<\/h3><\/dt>\n<dd><p>You need a Payexa merchant account and a valid live API key from https:\/\/pexn.ir.<\/p><\/dd>\n<dt id=\"what%20happens%20after%20the%20customer%20returns%20from%20payexa%3F\"><h3>What happens after the customer returns from Payexa?<\/h3><\/dt>\n<dd><p>The plugin verifies the transaction with Payexa and then updates the WooCommerce order status based on the verification result.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20log%20api%20activity%3F\"><h3>Does the plugin log API activity?<\/h3><\/dt>\n<dd><p>Yes. It uses the WooCommerce logger for request, response, and error events.<\/p><\/dd>\n<dt id=\"can%20i%20use%20this%20plugin%20without%20woocommerce%3F\"><h3>Can I use this plugin without WooCommerce?<\/h3><\/dt>\n<dd><p>No. WooCommerce is a required dependency for this plugin.<\/p><\/dd>\n<dt id=\"when%20is%20an%20order%20marked%20as%20paid%3F\"><h3>When is an order marked as paid?<\/h3><\/dt>\n<dd><p>The order is completed only after the verification request succeeds. If Payexa reports an already verified transaction, the plugin avoids double finalization.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release of the Payexa gateway for WooCommerce<\/li>\n<li>Added payment request, verification, and callback handling<\/li>\n<li>Added Persian RTL settings and checkout presentation<\/li>\n<li>Added standard WooCommerce success and failure return handling<\/li>\n<\/ul>","raw_excerpt":"WooCommerce payment gateway integration for Payexa with sandbox support, transaction verification, and a Persian checkout experience.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/307346","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=307346"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/payexa"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=307346"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=307346"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=307346"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=307346"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=307346"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=307346"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}