Title: Ezone Pay
Author: ezonepay
Published: <strong>2. јун 2026.</strong>
Last modified: 14. јун 2026.

---

Претражи додатке

![](https://ps.w.org/ezone-pay/assets/banner-772x250.png?rev=3558059)

![](https://ps.w.org/ezone-pay/assets/icon-256x256.png?rev=3558059)

# Ezone Pay

 [ezonepay](https://profiles.wordpress.org/ezonepay/)

[Преузимање](https://downloads.wordpress.org/plugin/ezone-pay.0.1.0.zip)

 * [Детаљи](https://sr.wordpress.org/plugins/ezone-pay/#description)
 * [Прегледи](https://sr.wordpress.org/plugins/ezone-pay/#reviews)
 *  [Постављање](https://sr.wordpress.org/plugins/ezone-pay/#installation)
 * [Изградња](https://sr.wordpress.org/plugins/ezone-pay/#developers)

 [Подршка](https://wordpress.org/support/plugin/ezone-pay/)

## Опис

Ezone Pay creates payment-link checkout sessions from WordPress. The plugin stores
a local payment reference, displays the returned payment link in an iframe, and 
updates payment status by polling the Ezone Pay API after the customer returns to
WordPress.

Features:

 * Development and production API modes.
 * Separate API keys for development and production.
 * Embedded iframe checkout for payment links.
 * Payment confirmation using Ezone Pay payment-link details and transactions.
 * Shortcode-based payment button.

Important: embedded checkout depends on Ezone Pay allowing your site domain in iframe/
frame headers. If the Ezone Pay checkout page blocks framing, Ezone Pay must allow
the merchant site domain or the browser will block the iframe.

### Configuration

The plugin supports two API modes:

 * Development: `https://test.ezonepay.ly`
 * Production: `https://api.ezonepay.ly`

To get a development API key, register or log in at `https://demo.ezonepay.ly/`,
then go to **الإعدادات > مفاتيح API**.

To get a production API key, register or log in at `https://my.ezonepay.ly/`, then
go to **الإعدادات > مفاتيح API**.

When creating an API key, enable these permissions:

 * **إنشاء رابط دفع**
 * **عرض روابط الدفع**

You can manage settings in WordPress admin or define constants in `wp-config.php`:

    ```
    define('EZONE_PAY_API_MODE', 'dev');
    define('EZONE_PAY_DEV_API_KEY', 'your-dev-secret-key');
    define('EZONE_PAY_PRODUCTION_API_KEY', 'your-production-secret-key');
    ```

If your WordPress server cannot resolve one of the default API hosts, you can override
the base URL:

    ```
    define('EZONE_PAY_DEV_BASE_URL', 'https://test.ezonepay.ly');
    define('EZONE_PAY_PRODUCTION_BASE_URL', 'https://api.ezonepay.ly');<h3>Shortcode</h3>
    ```

Use:

    ```
    [ezone_pay_button amount="0.1" reference="ORDER-123" title="Pay with Ezone"]
    ```

Optional customer fields:

    ```
    [ezone_pay_button amount="0.1" reference="ORDER-123" title="Pay with Ezone" customer_first_name="Ali" customer_last_name="Saleh" customer_phone="0910000000"]
    ```

Ezone Pay requires customer data when creating a payment link. If the shortcode 
does not include customer details, the plugin sends `WordPress Guest` and `0910000000`.

### Customer data

The plugin sends customer data to Ezone Pay in this shape:

    ```
    Customer.FirstName
    Customer.LastName
    Customer.PhoneNumber
    ```

Customer values can come from shortcode attributes:

    ```
    [ezone_pay_button amount="0.1" reference="ORDER-123" title="Pay with Ezone" customer_first_name="Ali" customer_last_name="Saleh" customer_phone="0910000000"]
    ```

If the shortcode does not provide customer values, the plugin uses these defaults:

    ```
    FirstName: WordPress
    LastName: Guest
    PhoneNumber: 0910000000
    ```

Developers can change the defaults with the `ezone_pay_default_customer` filter:

    ```
    add_filter('ezone_pay_default_customer', function ($customer) { return ['FirstName' => 'Site', 'LastName' => 'Customer', 'PhoneNumber' => '0910000000']; });
    ```

Developers can read the stored customer data after payment completion from the `
ezone_pay_payment_marked_paid` action:

    ```
    add_action('ezone_pay_payment_marked_paid', function ($order_reference, $payment) { $first_name = $payment['customer']['FirstName'] ?? ''; $phone = $payment['customer']['PhoneNumber'] ?? ''; }, 10, 2);<h3>Payment confirmation</h3>
    ```

When a customer clicks the shortcode button, the plugin creates a single-use Ezone
Pay payment link and stores the local payment session in WordPress.

After Ezone Pay sends the customer back to WordPress, the plugin marks the local
session as returned and polls Ezone Pay directly using payment-link details and 
transactions. The selected API key must have permission to create and view payment
links.

The local status endpoint is:

    ```
    /wp-json/ezone-pay/v1/status/{order_reference}?status_token={status_token}
    ```

That endpoint returns the current local payment status, such as `pending`, `returned`,
or `paid`. The status token is generated by the plugin and stored with the payment
session.

### After payment is completed

When Ezone Pay confirms the payment, the plugin updates the stored payment status
to `paid`, records `paid_utc`, and exposes filters/actions so the site can decide
what to show or do next.

Developers can customize the payment completed message with the `ezone_pay_completed_message`
filter, change the success URL with the `ezone_pay_success_url` filter, and provide
site-specific content with the `ezone_pay_completed_content` filter.

To run custom site logic after a payment is marked paid, use the `ezone_pay_payment_marked_paid`
action:

    ```
    add_action('ezone_pay_payment_marked_paid', function ($order_reference, $payment) { /* Update your order here. */ }, 10, 2);<h3>External services</h3>
    ```

This plugin connects to the Ezone Pay API to create payment links, display the Ezone
Pay checkout page, and confirm whether a payment has been completed. This service
is provided by Ezone.

The plugin connects to one of these Ezone Pay API endpoints depending on the selected
environment mode:

 * Development: `https://test.ezonepay.ly`
 * Production: `https://api.ezonepay.ly`

When a visitor clicks the payment button, the plugin sends the configured Ezone 
Pay API key, payment amount, payment title, optional note, order reference, internal
reference, WordPress return URL, and optional customer first name, last name, and
phone number to Ezone Pay. This data is sent so Ezone Pay can create a payment link
and return the checkout URL.

After the visitor is redirected back to WordPress, the plugin may send the configured
Ezone Pay API key, payment link ID, amount, and order reference to Ezone Pay to 
check payment-link details and payment-link transactions. This data is sent so WordPress
can confirm whether the payment was completed.

The checkout itself is loaded from the payment link returned by Ezone Pay. Any payment
details entered by the customer inside the Ezone Pay checkout are submitted directly
to Ezone Pay and are not processed by this plugin.

Terms of service: https://ezonepay.ly/ar/terms

Privacy policy: https://ezonepay.ly/ar/privacy

### Trademark notice

This plugin uses the Ezone Pay name to identify the payment service it integrates
with. Public distribution should only proceed after you confirm that you have permission
from the Ezone Pay trademark owner to use the name, brand, and any related marks.

## Постављање

 1. Upload the `ezone-pay` folder to `/wp-content/plugins/`.
 2. Activate **Ezone Pay** in WordPress.
 3. Go to **Settings > Ezone Pay**.
 4. Choose the environment mode.
 5. Add the development and/or production API keys.
 6. Make sure each API key has the **Create Payment Link** and **View Payment Links**
    permissions enabled.
 7. Add the shortcode to a page.

## ЧПП

### Does this plugin process card or wallet credentials?

No. The plugin creates Ezone Pay payment links and embeds the returned checkout 
URL.

### Why does the payment page stay on „waiting for confirmation“?

WordPress has not yet confirmed the payment. Make sure the API key can view payment
links and transactions.

### Why is the iframe blank or blocked?

The Ezone Pay checkout page may be using frame-blocking headers. Ezone Pay must 
allow the merchant domain for iframe checkout.

## Прегледи

Нема рецензија за овај додатак.

## Сарадници и градитељи

„Ezone Pay“ је софтвер отвореног кода. Следећи људи су допринели овом додатку.

Сарадници

 *   [ ezonepay ](https://profiles.wordpress.org/ezonepay/)

[Преведите „Ezone Pay“ на свој језик.](https://translate.wordpress.org/projects/wp-plugins/ezone-pay)

### Заинтересовани сте за градњу?

[Прегледајте код](https://plugins.trac.wordpress.org/browser/ezone-pay/), проверите
[SVN складиште](https://plugins.svn.wordpress.org/ezone-pay/) или се пријавите на
[белешку градње](https://plugins.trac.wordpress.org/log/ezone-pay/) преко [RSS-а](https://plugins.trac.wordpress.org/log/ezone-pay/?limit=100&mode=stop_on_copy&format=rss).

## Белешка о изменама

#### 0.1.0

 * Initial release.

## Мета

 *  Version **0.1.0**
 *  Last updated **2 седмице раније**
 *  Active installations **Мање од 10**
 *  WordPress version ** 6.0 или новије **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 или новије **
 *  Language
 * [English (US)](https://wordpress.org/plugins/ezone-pay/)
 * Tags
 * [checkout](https://sr.wordpress.org/plugins/tags/checkout/)[payment link](https://sr.wordpress.org/plugins/tags/payment-link/)
   [payments](https://sr.wordpress.org/plugins/tags/payments/)
 *  [Напредни преглед](https://sr.wordpress.org/plugins/ezone-pay/advanced/)

## Оцене

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/ezone-pay/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/ezone-pay/reviews/)

## Сарадници

 *   [ ezonepay ](https://profiles.wordpress.org/ezonepay/)

## Подршка

Имате нешто да кажете? Потребна вам је помоћ?

 [Види форум подршке](https://wordpress.org/support/plugin/ezone-pay/)