Aura Historia Partner Connect

Description

Aura Historia Partner Connect connects a WooCommerce store to Aura Historia.

After you connect the store through Aura Historia OAuth, the plugin automatically:

• creates and maintains exactly three WooCommerce product webhooks:
  • product.created
  • product.updated
  • product.deleted
• keeps those managed webhooks in sync without creating duplicates
• repairs plugin-owned webhooks after manual edits or deletion
• generates and stores the WooCommerce webhook signing secret automatically
• sends webhook deliveries to Aura Historia using the built-in endpoint pattern
• pauses plugin-owned webhooks on deactivation
• removes plugin-owned webhooks and plugin options on uninstall
• can re-send the current catalog in the background after a successful connection

The plugin keeps the settings surface intentionally small. Merchants do not manually enter Aura Historia credentials in wp-admin. The OAuth flow sets and stores:

• Shop ID
• Aura Historia access token

Merchants do not enter:

• a webhook delivery URL
• a webhook secret

This plugin is intended for merchants who already use Aura Historia. Once OAuth completes, the plugin sends product data to Aura Historia so the connected catalog can stay in sync.

External services

This plugin connects to Aura Historia, a hosted service required for the plugin to work.

It sends data after a merchant connects the store through Aura Historia OAuth, and later when WooCommerce sends managed webhook events or the plugin runs a product backfill.

The service is used to:

• register the generated WooCommerce webhook secret and current store locale details
• receive ongoing product webhook deliveries
• receive background product backfill batches

Data sent to the service may include:

• Shop ID
• Aura Historia access token in the bearer Authorization header for backend API calls
• Aura Historia access token in the webhook x-api-key header for WooCommerce deliveries
• generated WooCommerce webhook secret
• store language and currency
• product webhook payloads for product.created, product.updated, and product.deleted
• existing product data during an automatic or manual backfill, with product descriptions converted from HTML to Markdown

Service endpoints:

• GET https://aura-historia.com/oauth/authorize
• GET https://aura-historia.com/api/oauth/client/redirect-broker/woocommerce
• GET https://api.aura-historia.com/api/v1/oauth/tokens/by-third-party-code/{thirdPartyCode}
• PATCH https://api.aura-historia.com/api/v1/shops/{shopId}
• POST https://api.aura-historia.com/api/v1/webhooks/woocommerce/{shopId}
• PUT https://api.aura-historia.com/api/v1/shops/{shopId}/products

Service provider and policies:

• Website
• Privacy Policy
• Terms and conditions
• Imprint