About this plugin
ir) is an Iranian card-to-card payment gateway with automatic confirmation. This plugin adds Payexa to the WooCommerce checkout. The customer pays with an ordinary card-to-card transfer in their own banking app.
Payexa confirms the transfer automatically, and the order is marked as paid. Nobody has to check receipts or bank messages by hand.
How a card-to-card payment is confirmed:
- At checkout the customer goes to the Payexa payment page, which shows the card number and the exact amount to transfer.
- Each payment gets a unique amount, so every deposit can be matched with the right order.
- The bank’s deposit SMS for the receiving card reaches Payexa through the Payexa Uploader Android app.
- Payexa matches the deposit with the pending payment and sends the customer back to the store. The plugin verifies the payment with Payexa before the order is marked as paid.
- Each payment stays open for 30 minutes.
Payexa offers two gateway types:
- Personal card-to-card: the money goes directly to the merchant’s own card.
- Admin card-to-card: the money is paid to Payexa’s cards and settled to the merchant’s account after 12 working hours.
No eNamad or tax code is needed to start. The merchant account is activated after identity verification and a review by the Payexa support team. The sandbox shows the whole payment flow without real money.
Useful links:
- Payexa website: https://pexn.ir
- WooCommerce setup guide (Persian): https://pexn.ir/tutorials/woocommerce-card-to-card-gateway-setup
- How automatic card-to-card confirmation works (Persian): https://pexn.ir/blog/how-card-to-card-auto-confirm-works
- API documentation: https://pexn.ir/doc
Plugin features:
- Sends payment requests to Payexa and redirects the customer to the hosted payment page.
- Verifies the transaction before marking the WooCommerce order as paid.
- Supports an explicit production or sandbox payment environment.
- Stores transaction details in WooCommerce order meta for support and reconciliation.
- Adds frontend checkout assets only on checkout and order received pages.
- Supports the classic WooCommerce checkout and the WooCommerce blocks checkout.
- Provides a Persian RTL interface for checkout and plugin settings.
- Automatically detects the WooCommerce store currency and converts Toman amounts to Rial before sending to the gateway. The currency setting can also be set manually.
How it works:
- The plugin creates a payment request through the Payexa API.
- The customer is redirected to Payexa to complete payment.
- Payexa returns the customer to WooCommerce through the callback endpoint.
- The plugin verifies the transaction with Payexa and updates the order status.
Requirements:
- WordPress 6.4 or newer
- WooCommerce 8.0 or newer
- A Payexa merchant account and API key for live payments
فارسی
پی‌اکسا درگاه پرداخت کارت به کارت با تأیید خودکار است. با این افزونه، خریدار فروشگاه ووکامرسی شما با برنامهٔ بانک خودش کارت به کارت می‌کند. پی‌اکسا واریز را از روی پیامک بانک شناسایی می‌کند و پرداخت را خودکار تأیید می‌کند.
سفارش پس از تأیید پرداخت «پرداخت‌شده» می‌شود و دیگر لازم نیست رسیدی را بررسی کنید.
- هر پرداخت مبلغ یکتا دارد تا واریز با سفارش درست تطبیق داده شود.
- مهلت هر پرداخت ۳۰ دقیقه است.
- دو نوع درگاه دارد: کارت به کارت شخصی که وجه مستقیم به کارت خود فروشنده واریز می‌شود، و کارت به کارت ادمین که وجه به کارت‌های پی‌اکسا واریز و پس از ۱۲ ساعت کاری تسویه می‌شود.
- برای شروع، اینماد و کد مالیاتی لازم نیست. حساب پس از احراز هویت و بررسی تیم پشتیبانی فعال می‌شود.
- سندباکس دارد و کل مسیر پرداخت را بدون پول واقعی نشان می‌دهد.
- با صفحهٔ پرداخت معمولی و بلوکی ووکامرس کار می‌کند و مبلغ تومان را خودکار به ریال تبدیل می‌کند.
ir/tutorials/woocommerce-card-to-card-gateway-setup
ir
Third-Party Services
This plugin connects to the external Payexa payment service to create and verify payment transactions.
What the service is used for:
- Creating payment requests for WooCommerce orders
- Redirecting the customer to the Payexa hosted payment page
- Verifying completed transactions before the order is marked as paid
What data is sent when a customer starts payment:
- Order amount
- Callback URL
- A unique merchant-side order reference
What data is sent when the plugin verifies a payment:
- Payexa request order ID returned by the payment request API
- The unique verification token returned by Payexa as amount_unique
When data is sent:
- A payment request is sent when the customer places an order and chooses this gateway.
- A verification request is sent after Payexa returns the customer to the WooCommerce callback URL.
Service endpoints used by the plugin:
- 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.
Provider policies:
- Terms of service: https://pexn.ir/terms
- Privacy policy: https://pexn.ir/privacy