Kevin Burkholder

{eac}SoftwareRegistry Webhook Endpoints is an extension plugin to <a href="https://swregistry.earthasylum.com/software-registration-server/" rel="nofollow ugc">{eac}SoftwareRegistry Software Registration Server</a>.
WooCommerce Webhooks are used to create or update a software registration in {eac}SoftwareRegistry when a WooCommerce order is created or updated.
<blockquote>
A Webhook is an event notification sent to a URL of your choice. Users can configure them to trigger events on one site to invoke behavior on another.
</blockquote>
The Software Registration Webhooks use the same internal methods as the Software Registry API (see <a href="https://swregistry.earthasylum.com/software-registry-sdk/" rel="nofollow ugc">Implementing the Software Registry SDK</a>).
We use webhooks so that you may sell your software on a different site then where you register your software. When an order is created or updated on your WooCommerce site, that order information is sent to your registration server via a webhook so that the registration server may create or update the registration.
WooCommerce Webhooks are created by going to: WooCommerce → Settings → Advanced → Webhooks from the dashboard of your WooCommerce shop site.
To get to the settings for this extension, go to Software Registry → Settings → Woocommerce from the dashboard of your software registration server.
On your WooCommerce site, use the Webhook Secret and Order Delivery URL defined by this extension when creating your webhooks. The Webhook Secret is used to authenticate the webhook and the Delivery URL is the webhook end-point (your registration server).
You should create a WooCommerce Webhook for Order created and Order updated, and you may optionally create webhooks for Order deleted and Order restored if your want registrations to be terminated or reactivated when an order is moved to the trash or restored.
* See <a href="#subscriptions" rel="nofollow ugc">Subscriptions</a> below.
On your registration server, select the appropriate Webhook Endpoints in this extension based on the WooCommerce webhooks created.
<h4>Product Variations and Registry Values</h4>
On your shop site, you may create a variable product with a product attribute (‘Used for variations’ checked), like:
<pre><code>registry_license -> 'Lite' | 'Basic' | 'Standard' | 'Professional' | 'Enterprise' | 'Developer'
</code></pre>
— and/or —
<pre><code>registry_count -> '1-User' | '10-Users' | '50-Users' | '100-Users' | 'Unlimited Users'
</code></pre>
Then configure (or remove) each of the variations accordingly. 
This produces a product variation for each license level (or user count) and passes <code>registry_license</code> (or <code>registry_count</code>) through the webhook overriding the default registration server settings.
As well, you may create an attribute and variation like:
<pre><code>registry_expires -> '14 Days' | '30 Days' | '6 Months' | '1 Year'
</code></pre>
To override the default registration term.
These variations may be combined to create a large number of variable products, each passing the given registry values through the webhooks. For example, one variable product may have a variation combination of <code>'Basic', '10-users', '6 Months'</code>
<h4>Item Mapping</h4>
On your registration server, you may specify the items (SKUs) that are to be registered in the Registration Item Mapping as:
<pre><code>item_sku=package_name or `item_sku=package_name1,package_name2` (to create a bundle).
</code></pre>
Even if the item sku is the product to be registered, enter <code>item_sku=item_sku</code>.
Items that don’t match these SKU(s) will be ignored.
Since WooCommerce won’t allow duplicate SKUs, regular expressions may be used for “item_sku” matching. For example: <code>MyItemSku*=MyPackage</code> Will match any SKU in the order beginning with “MyItemSku” (e.g. “MyItemSku_1”, “MyItemSku_2”) and map (register) it as “MyPackage”.
<h4>Subscriptions</h4>
By adding <a href="https://swregistry.earthasylum.com/subscriptions-for-woocommerce/" rel="nofollow ugc">{eac}SoftwareRegistry Subscriptions for WooCommerce</a> to your WooCommerce store site, subscription orders and updates (when using <a href="https://woocommerce.com/document/subscriptions/" rel="nofollow ugc">Woo Subscriptions</a> or <a href="https://codecanyon.net/item/sumo-subscriptions-woocommerce-subscription-system/16486054" rel="nofollow ugc">SUMO Subscription</a>), as well as product meta data, may also be passed to your registration server.
{eac}SoftwareRegistry Subscriptions for WooCommerce is a plugin, installed on your WooCommerce site, that adds a custom Webhook topic for subscription updates to the WooCommerrce webhooks, and adds subscription and product data to WooCommerce order webhooks.
On your WooCommerce site, add a new Webhook using {eac}SoftwareRegistry WC Subscription or {eac}SoftwareRegistry Sumo Subscription for the topic; the same Webhook Secret used for the order webhooks; and the Subscription Delivery URL rather than the Order Delivery URL.
With this plugin enabled, not only can you update registrations by order updates, but also by subscription updates, including renewals, expirations, and cancelations, making it easy to keep your registrations in sync with your subscriptions.
In addition, this plugin will add product meta data to the orders and subscriptions passed through the webhooks so that you may define registry values as custom fields at the product level.
For example, rather than needing to create variable products, you can simply add custom fields:
<pre><code>registry_license -> 'Basic'
registry_count -> '10-Users'
registry_expires -> '6 Months'
</code></pre>
And, rather than relying on the <code>item_sku</code> list in the Registration Item Mapping, you can add a custom field…
<pre><code>registry_product -> 'package_name'
</code></pre>
…that will register or update any subscription for the given item as <code>package_name</code> regardless of the item’s SKU or the Registration Item Mapping list.
If all of your orders are subscriptions…
With this plugin enabled on your shop site, there’s a high probability you don’t need to use the “order” webhooks. Your subscriptions will be updated more efficiently from the shop subscription records.
When a new (or renewal) subscription order is created, it will trigger the “Order created”, “Order updated” (payment processed) and the “Subscription updated” webhooks when all you need is the subscription to create or update the registration.
On the other hand, since this plugin adds an array of subscription records to the orders passed through the webhooks, you may prefer to use only the order webhooks and not the subscription webhook.
<h4>Return Value</h4>
As of version 1.1, this plugin now returns a result array which can be retrieved via the <code>woocommerce_webhook_delivery</code> action:
<pre><code>array(
 'action' => string // the webhook action,
 'resource' => int // the webhook resource id (order/subscription id),
 'status' => string // 'success' | 'ignored' | 'error',
 'result' => array|string // success: array of [ sku => [status => registry_key | error_message] ]
 // ignored|error: string error_message
)
</code></pre>
Note that ‘success’ means the webhook was succesfull, ‘result’ could contain an error status/message from {eac}SoftwareRegistry.
Examples:
<pre><code>array(
 'action' => 'order.created',
 'resource' => 2715,
 'status' => 'ignored',
 'result' => 'order with subscription',
),

array(
 'action' => 'action.wc_eacswregistry_sumosub',
 'resource' => 2715,
 'status' => 'success',
 'result' => array (
 0 => array(
 'eacDoojigger' => array(
 '200' => 'bad53cd3-f397-4f47-9d28-xxxxxxxxxxxx',
 ),
 ),
 1 => array(
 'eacSoftwareRegistry' => array(
 '406' => 'registration with this email and product already exists',
 ),
 ),
 ),
),
</code></pre>
<h4>See Also</h4>
<ul>
<li>
<a href="https://swregistry.earthasylum.com/software-registration-server/" rel="nofollow ugc">{eac}SoftwareRegistry – Software Registration Server</a>
</li>
<li>
<a href="https://swregistry.earthasylum.com/subscriptions-for-woocommerce/" rel="nofollow ugc">{eac}SoftwareRegistry Subscriptions for WooCommerce</a>
</li>
<li>
<a href="https://swregistry.earthasylum.com/software-registry-sdk/" rel="nofollow ugc">Implementing the Software Registry SDK</a>
</li>
</ul>
<h3>Copyright</h3>
<h4>Copyright © 2019-2025, EarthAsylum Consulting, distributed under the terms of the GNU GPL.</h4>
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should receive a copy of the GNU General Public License along with this program. If not, see <a href="https://www.gnu.org/licenses/" rel="nofollow ugc">https://www.gnu.org/licenses/</a>.

{eac}SoftwareRegistry WooCommerce Webhook Endpoints

Enables the use of WooCommerce Webhooks to create or update a software registration in {eac}SoftwareRegistry when an order or subscription is created  …

{eac}SoftwareRegistry Software Taxonomy is an extension plugin to <a href="https://swregistry.earthasylum.com/software-registration-server/" rel="nofollow ugc">{eac}SoftwareRegistry Software Registration Server</a>.
Now with <a href="https://swregistry.earthasylum.com/github-hosting/" rel="nofollow ugc">plugin hosting on Github</a> to provide complete, automated plugin information and updates in WordPress.
{eac}SoftwareRegistry Software Taxonomy is a simple plugin extension that allows you to set and override {eac}SoftwareRegistry options for specific software products. It both defines the software product as well as the server parameters used when that product is registered via the software registration application program interface.
When an API request is received by the registry server, the <code>registry_product</code> is matched to the software taxonomy slug. When a match is found, the parameters entered in the software taxonomy meta data are used to override the registry server default parameters.
<h4>Options set on a per-product basis by this extension</h4>
<ul>
<li>
Software Product
<ul>
<li>Registry Title – The Software Product display name</li>
<li>Registry Description – The Software Product Description</li>
</ul>
</li>
<li>
Registrar Contact (override existing global options in {eac}SoftwareRegistry)
<ul>
<li>Registrar Name – Sending client email from this name</li>
<li>Registrar Telephone – Include telephone in client notifications</li>
<li>Registrar Support Email – Include support email address in client notifications</li>
<li>Registrar Web Address – Include web address in client notifications</li>
</ul>
</li>
<li>
Registration Defaults (override existing global options in {eac}SoftwareRegistry)
<ul>
<li>Default Status – The default status to assign to newly created registrations</li>
<li>Default Initial Term – The initial term when creating a new registration (pending or trial)</li>
<li>Default Full Term – The full term when activating a registration</li>
<li>Default License – The default license level (L1-L5, LD) to assign to newly created registrations</li>
</ul>
</li>
<li>
Client Notification (Customize the email message and API response notifications sent to the client)
<ul>
<li>Client Email Message – Message sent to client on creation, activation or update of registration.</li>
<li>Client API Message – Short message included with all API responses.</li>
<li>Client Success Notice – Success notification sent via API response.</li>
<li>Client Error Notice – Error notification sent via API response.</li>
</ul>
</li>
<li>
License Limitations
<ul>
<li>see below</li>
</ul>
</li>
<li>
GitHub Hosting
<ul>
<li>WordPress Plugin Slug – The {directory}/{plugin.php} slug of the WordPress plugin.</li>
<li>GitHub Repository – The {owner}/{repository} id of the github repository.</li>
<li>Repository Source – Select which source to use from the repository (branch, release).</li>
<li>Tag Name – (Optional) Specific release or branch tag name (or id).</li>
<li>Path to readme.txt – Pathname within the repository to the readme.txt file. 
If blank, the json file will be generated from information available in the GitHub repository.</li>
<li>GitHub Access Token – Your GitHub personal access token, Increases the github rate limit and is required for private repositories.</li>
<li>Plugin URLs – Displays the URL(s) you will need for your plugin file and readme.txt file.</li>
</ul>
</li>
</ul>
License Limitations
Based on the license level assigned to a registration, we can limit the optional values in the registration API (count, variations, options, domains & sites). This allows APIs (possibly from multiple sources) to register any/all values for these options while filtering on the registration server, providing an effective (albeit rudimentary) licensing validation.
For each license level ( L1=Lite, L2=Basic, L3=Standard, L4=Professional, L5=Enterprise, LD=Developer ) you may set a limit for count, variations, options, domains, and sites.
<ul>
<li>count – Number of licenses (users/seats/devices)</li>
<li>variations – List of custom name/value pairs</li>
<li>options – List of custom registry options</li>
<li>domains – List of valid/registered domains</li>
<li>sites – List of valid/registered sites/uris</li>
</ul>
For count, the value passed through the API is limited to a maximum value. 
For variations, options, domains, and sites, the arrays passed through the API are sliced to a maximum number of elements.
<h4>GitHub Hosting</h4>
<blockquote>
* GitHub hosting requires installation of the <a href="https://wordpress.org/plugins/eacreadme/" rel="ugc">{eac}Readme plugin</a> in order to process readme.txt files.
</blockquote>
Wether you’re using software registration or not, you can use Github Hosting to manage your software releases and provide automated updates for your WordPress plugins.
New in version 2.0, these options allow for the “self-hosting” of WordPress plugins on GitHub in a way similar to and meeting the requirements of the <a href="https://wordpress.org/plugins/eacsoftwareregistry-software-taxonomy/" rel="ugc">WordPress plugin repository</a>.
More details may be found in the included <a href="https://swregistry.earthasylum.com/github-hosting/" rel="nofollow ugc">readme_github.md</a> file.
<h4>See Also</h4>
<ul>
<li>
<a href="https://swregistry.earthasylum.com/software-registration-server/" rel="nofollow ugc">{eac}SoftwareRegistry – Software Registration Server</a>
</li>
<li>
<a href="https://swregistry.earthasylum.com/software-registry-sdk/" rel="nofollow ugc">Implementing the Software Registry SDK</a>
</li>
</ul>
<h3>Copyright</h3>
<h4>Copyright © 2019-2025, EarthAsylum Consulting, distributed under the terms of the GNU GPL.</h4>
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should receive a copy of the GNU General Public License along with this program. If not, see <a href="https://www.gnu.org/licenses/" rel="nofollow ugc">https://www.gnu.org/licenses/</a>.

{eac}SoftwareRegistry Software Taxonomy

Software Product Taxonomy - Customize {eac}SoftwareRegistry with options, licensing, client messaging, and Github hosting for each software product.

{eac}SoftwareRegistry WooCommerce Webhook Endpoints vs {eac}SoftwareRegistry Software Taxonomy