FAIR

Federated and Independent Repositories

Saudi VAT Pro for WooCommerce

Plugin Banner

Saudi VAT Pro for WooCommerce

by SaudiAddressPro

Download
Description

Saudi VAT Pro sends paid orders and refunds to your Saudi VAT Pro WooCommerce integration endpoint. It can collect an optional 15-digit Saudi buyer VAT number for B2B invoices, show a returned PDF link, and submit a credit note for each refund.

Requirements

  • WordPress 6.0+, PHP 8.0+, and WooCommerce 7.0+.
  • An active Saudi VAT Pro account at https://saudivatpro.com.
  • A unique HTTPS WooCommerce webhook URL and its secret from Saudi VAT Pro Settings Integrations WooCommerce.

Installation

  1. Activate the plugin.
  2. Go to WooCommerce Settings Saudi VAT Pro.
  3. Paste the required HTTPS Webhook URL and its required Webhook Secret. This plugin does not use an API key.
  4. Save settings and place a test order in your Saudi VAT Pro environment.

Configuration and usage

The plugin submits paid orders to Saudi VAT Pro for electronic invoicing and stores the returned invoice identifier and PDF link on the WooCommerce order. When a refund is created, the plugin submits the refunded items to create a matching credit note. Failed submissions can be retried from the order screen.

The classic shortcode checkout is supported. WooCommerce block checkout does not currently expose this plugin’s optional VAT field; collect the VAT number by another compatible checkout extension until native block integration is released.

Compatibility

This release supports WordPress 6.0 or newer, PHP 8.0 or newer, and WooCommerce 7.0 or newer. It supports WooCommerce HPOS. The classic shortcode checkout is supported; the optional VAT field is not currently available in WooCommerce block checkout.

Privacy Policy

When a paid order or refund is submitted, order identifiers, billing details, purchased items, prices, taxes, and the optional VAT number are sent to Saudi VAT Pro at the merchant-configured webhook URL for invoicing and ZATCA processing. The plugin stores the returned invoice identifier, PDF URL, and submission error on the WooCommerce order. It does not send data to any other endpoint. Merchants are responsible for informing customers and configuring their Saudi VAT Pro account lawfully. See https://saudivatpro.com/privacy for Saudi VAT Pro’s privacy policy.

Support

For setup help or support, visit https://saudivatpro.com or contact the Saudi VAT Pro team through your account.

1.0.1

  • Hardened option and order-meta names with a one-time migration from prior names.
  • Added HPOS-safe order metadata handling and response validation.
  • Required HTTPS webhook URL and webhook secret; removed misleading API key setup.
  • Improved retry safety and classic checkout script idempotency.
  • Submit actual post-discount order totals, including fees and shipping.
  • Retry each exact refund durably without re-crediting completed refunds.
  • Documented block checkout limitation and privacy handling.

1.0.0

  • Initial release.
Back to top