Tahanoa Invoice Links for ZarinPal

Tahanoa Invoice Links for ZarinPal lets a WordPress administrator create a payment invoice, copy its public link, and send that link to a customer. The customer sees the invoice inside a normal WordPress page, so the active theme remains responsible for the header, footer, trust badges, navigation, and other site elements.

The plugin works without WooCommerce for manual-amount invoices. If WooCommerce is active, administrators can search products by name or SKU, choose quantities, and add those products to an invoice. Product prices are read again on the server when the invoice is created and saved as a snapshot, so browser-submitted prices are not trusted and later catalog price changes do not alter an existing invoice.

Features include:

• Manual-amount invoices.
• Optional WooCommerce product search by name or SKU.
• Server-side product-price snapshot at invoice creation time.
• Configurable fixed shipping amount, enabled per invoice.
• Public invoice page rendered through a shortcode inside the active theme.
• ZarinPal payment Request, Verify, and Inquiry integration.
• Server-side amount verification and stored-Authority matching.
• Admin-only manual re-verification for recovery after temporary API/callback errors.
• Optional, redacted rolling debug logging stored in WordPress (disabled by default).
• WordPress Privacy Tools support for exporting customer invoice data and erasing contact fields by email.
• Public invoice URLs request no-cache and no-index behavior.
• Optional data removal on uninstall (disabled by default).
• Backward-compatible migration from the previous 1.4.x private build.
• No PDF generation.
• No telemetry sent to the plugin author.

This plugin is an independent integration and is not an official ZarinPal plugin.

External service disclosure

This plugin connects to ZarinPal, an external payment service, only when payment-related actions require it:

• When a customer starts a payment, the plugin sends the configured merchant ID, invoice amount, currency, invoice description, callback URL, invoice/order ID, and optional customer mobile/email fields to ZarinPal.
• When a payment callback is received, the plugin sends the stored merchant ID, stored invoice amount, and stored Authority to ZarinPal’s Verify API.
• When an administrator explicitly clicks Inquiry, the plugin sends the merchant ID and stored Authority to ZarinPal’s Inquiry API.

A ZarinPal merchant account and Merchant ID are required to accept payments.

Service website: https://www.zarinpal.com/

Terms of service: https://www.zarinpal.com/terms

Privacy / information security policy: https://www.zarinpal.com/policy

The plugin author does not receive payment data, customer data, telemetry, or analytics from sites using this plugin.

WooCommerce notes

WooCommerce is optional. When enabled, this plugin reads product/variation names, SKU values, and current prices to build invoice line items. It does not create a WooCommerce order, reserve stock, apply coupons, calculate shipping methods, or run WooCommerce checkout. The invoice stores its own product-price snapshot.

WooCommerce currency is supported directly when it is IRR (Rial) or a Toman-style currency code such as IRT/TMN. Developers can provide another conversion multiplier with the ezinv_woocommerce_price_to_irr_multiplier filter.