內容簡介
{eac}SoftwareRegistry Subscriptions for WooCommerce是一個插件，安裝在你的WooCommerce網站上，將自訂的Webhook主題添加到WooCommerrce Webhooks上以進行訂閱更新，並將訂閱和產品數據添加到WooCommerce訂單Webhooks中。
添加一個自訂Webhook主題到WooCommerce Webhooks，用於訂閱更新。
通過添加訂閱數據到訂閱的訂單中，擴展了WooCommerce訂單Webhooks的功能。
將產品元數據附加到通過WooCommerce Webhooks傳遞的訂單和訂閱記錄中。
當WooCommerce創建一個訂單時，該訂單會作為一個帶有“shop_order“類型的文章存儲。當該訂單是訂閱訂單時，相關的訂單會作為一個帶有“shop_subscription“類型的文章存儲。當訂閱更新時，會創建一個新的“shop_order”與原“shop_subscription”訂單相關聯。
當通過“{eac}SoftwareRegistry Subscription updated” webhook傳遞訂閱（shop_subscription）時，會在傳遞的訂閱訂單記錄中添加附加的訂閱數據和相關訂單號。
當通過WooCommerce訂單創建，訂單更新，和訂單恢復Webhooks傳遞訂單（shop_order）時，該插件將附加任何相關的帶有訂閱數據和相關訂單號的shop_subscription訂單。
訂單中的產品元數據（自定義字段和屬性）可能被附加到訂單和訂閱記錄中。
對於Webhooks的訂單，可以在“Webhook”編輯屏幕上提供選項以選擇應添加到訂單中的數據，以便在需要檢索和通過Webhook發送擴展數據時使用。
要創建訂閱更新的Webhook，請在商店網站的管理中，前往：WooCommerce → 設置 → 高級 → Webhooks。
訂閱
要為訂閱更新創建Webhook，請在Webhook數據屏幕上為主題選擇“{eac}SoftwareRegistry Subscription updated”。
每當訂閱更新時，訂閱數據將發送到Webhook中指定的送達URL。
訂單
該插件還會在訂單創建，訂單更新和訂單恢復Webhook傳遞訂單中添加訂閱數據，只有當該訂單有關聯的訂閱時才會進行添加。
沒有訂閱的訂單可以從該訂單中的產品元數據中附加。
訂閱數據
Webhooks中添加的訂閱數據（疊加在shop_subscription記錄上）包括：
'date_created' => datetime // 'YYYY-MM-DDThh:mm:ss',
'date_modified' => datetime // 'YYYY-MM-DDThh:mm:ss',
'date_paid' => datetime // 'YYYY-MM-DDThh:mm:ss',
'date_completed' => datetime // 'YYYY-MM-DDThh:mm:ss',
'last_order_id' => int // 最後完成的訂單ID,
'last_order_date_created' => datetime // 'YYYY-MM-DDThh:mm:ss',
'last_order_date_paid' => datetime // 'YYYY-MM-DDThh:mm:ss',
'last_order_date_completed' => datetime // 'YYYY-MM-DDThh:mm:ss',
'schedule_trial_end' => datetime // 'YYYY-MM-DDThh:mm:ss',
'schedule_start' => datetime // 'YYYY-MM-DDThh:mm:ss',
'schedule_end' => datetime // 'YYYY-MM-DDThh:mm:ss',
'schedule_cancelled' => datetime // 'YYYY-MM-DDThh:mm:ss',
'schedule_next_payment' => datetime // 'YYYY-MM-DDThh:mm:ss',
'schedule_payment_retry' => datetime
外掛標籤
開發者團隊
② 後台搜尋「{eac}SoftwareRegistry Subscriptions for WooCommerce」→ 直接安裝（推薦）
原文外掛簡介
{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.
Adds a custom Webhook topic for subscription updates to WooCommerce Webhooks.
Extends the WooCommerce Order Webhooks by adding subscription data to orders with subscriptions.
Adds product meta data to order and subscription records passed through WooCommerce webhooks.
Works with WooCommerce Subscriptions – and – SUMO Subscriptions.
When WooCommerce creates an order, the order is stored with type set to “shop_order“. When the order is for a subscription, a related order is stored with type set to “shop_subscription“. When a subscription is renewed, a new “shop_order” is created related back to the original “shop_subscription” order.
When subscriptions (shop_subscription) are passed through the “{eac}SoftwareRegistry WC Subscription” webhook, additional subscription data and related order numbers are added to the subscription order record being passed.
When orders (shop_order) are passed through the WooCommerce Order created, Order updated, and Order restored webhooks, this plugin will append any related shop_subscription orders with the additional subscription data and related order numbers.
Meta data (custom fields and attributes) from the products in the order may be appended to the order and subscription records.
For order webhooks, options are presented on the “Webhook” edit screen to choose what data may be added to the orders so that extended data is only retrieved and sent through the webhook where needed.
WooCommerce Webhooks are created by going to: WooCommerce → Settings → Advanced → Webhooks in the administration of your store site.
With version 2+, SUMO Subscriptions is also supported in nearly the same way as WooCommerce Subscriptions by creating a pseudo shop_subscription order from the SUMO Subscription post record and the original or renewal WooCommerce shop_order.
Subscriptions
To create a webhook for subscription updates, choose “{eac}SoftwareRegistry WC Subscription”, when using Woo Subscriptions, or “{eac}SoftwareRegistry Sumo Subscription”, when using SUMO Subscriptions, for the topic on the Webhook data screen.
Whenever a subscription is updated, the subscription data will be sent to the Delivery URL specified in the Webhook.
Orders
This plugin also adds subscription data to orders passed through the Order created, Order updated, and Order restored webhooks when the order has related subscription(s).
Orders without subscriptions may be appended with meta data from the products in the order.
Subscription Data
The subscription data added (overlayed on the shop_subscription record) in the webhooks is:
'date_created' => datetime // 'YYYY-MM-DDThh:mm:ss',
'date_modified' => datetime // 'YYYY-MM-DDThh:mm:ss',
'date_paid' => datetime // 'YYYY-MM-DDThh:mm:ss',
'date_completed' => datetime // 'YYYY-MM-DDThh:mm:ss',
'last_order_id' => int // last completed order id,
'last_order_date_created' => datetime // 'YYYY-MM-DDThh:mm:ss',
'last_order_date_paid' => datetime // 'YYYY-MM-DDThh:mm:ss',
'last_order_date_completed' => datetime // 'YYYY-MM-DDThh:mm:ss',
'schedule_trial_end' => datetime // 'YYYY-MM-DDThh:mm:ss',
'schedule_start' => datetime // 'YYYY-MM-DDThh:mm:ss',
'schedule_end' => datetime // 'YYYY-MM-DDThh:mm:ss',
'schedule_cancelled' => datetime // 'YYYY-MM-DDThh:mm:ss',
'schedule_next_payment' => datetime // 'YYYY-MM-DDThh:mm:ss',
'schedule_payment_retry' => datetime // 'YYYY-MM-DDThh:mm:ss',
'billing_period' => string // 'day','month','year',
'billing_interval' => int // number of days,months,years,
'sign_up_fee' => float // signup fee amount,
'product_meta' => array // [ product_id => [product_meta_data] ]
'related_orders' => array // [ order_id => type ('parent','renewal','resubscribe','switch') ]
product_meta includes:
'id' => int // product id,
'name' => string // product name,
'slug' => string // product slug,
'sku' => string // product sku,
'attributes' => array // product attributes (name => value)
'meta_data' => array // product custom fields (name => value)
'categories' => array // product categories (slug => name)
For the subscription webhook, this data is overlayed on the subscription order created by WooCommerce.
For the order webhooks, this data is overlayed on the related subscription order and appended to the shop_order in a “subscriptions” array, indexed by id (allowing for multiple subscriptions per order).
For orders without subscriptions, the product_meta array is appended to the shop_order.
SUMO Subscriptions
The pseudo subscription order is built by taking the SUMO subscription post record and overlaying the most recent shop_order. The ‘id’ number of the pseudo order is the subscription post id. The parent id is the original shop_order that created the subscription.
Using With {eac}SoftwareRegistry Registration Server
You must have the {eac}SoftwareRegistry WebHooks for WooCommerce extension enabled on your Software Registration server.
When creating a subscription webhook, the Delivery URL for “{eac}SoftwareRegistry WC Subscription” and “{eac}SoftwareRegistry Sumo Subscription” is:
https://{your_registration_server}.com/wp-json/softwareregistry/v1/wc-subscription
When creating order webhooks, the Delivery URL for Order created, Order updated, Order deleted and Order restored is:
https://{your_registration_server}.com/wp-json/softwareregistry/v1/wc-order
With this configuration, you can pass registry values (registry_*) in the product_meta array by creating custom fields on the product record and overriding the registration server defaults. For example:
registry_product = package_name
registry_license = Basic
See {eac}SoftwareRegistry WebHooks for WooCommerce for more information.
Additional Information
Requires WooCommerce and either WooCommerce Payments (with subscriptions), WooCommerce Subscriptions or SUMO Subscriptions.
Developed for use with {eac}SoftwareRegistry Registration Server.
Nonetheless can be used wherever subscriptions or additional product details are needed in WooCommerce webhooks.
See Also
{eac}SoftwareRegistry – Software Registration Server
{eac}SoftwareRegistry WebHooks for WooCommerce
Copyright
Copyright © 2025, EarthAsylum Consulting, distributed under the terms of the GNU GPL.
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 https://www.gnu.org/licenses/.
