Digital Goods Payments for AgentaOS

AgentaOS Pay adds an AgentaOS payment gateway to WooCommerce for selling digital goods.

Important: digital goods only. This gateway is for non-shippable products (virtual / downloadable). It automatically hides itself at checkout whenever the cart contains any physical (shippable) product, and the product-page “Buy now” button is never shown for physical products. It does not support physical goods.

• Hosted, seamless checkout — buyers pay on a secure AgentaOS page and return to your store fulfilled.
• Fast checkout on product pages — a “Buy now” button skips the cart and goes straight to AgentaOS.
• Standard checkout — works on both the classic checkout and the Cart/Checkout Blocks.
• Sandbox & live environments — separate keys and webhook secrets, switch with one setting.
• Signed webhooks — HMAC-SHA256 verification, plus a server-side return check so orders are fulfilled even where webhooks can’t reach the store (e.g. local dev).
• Digital-goods aware — virtual/downloadable orders auto-complete so downloads unlock instantly.

Architecture note: the @agentaos/pay npm package

WooCommerce runs on PHP, so the gateway itself is implemented in PHP and calls the AgentaOS REST API directly (the same API the SDK wraps). The official @agentaos/pay Node SDK holds a secret key and is therefore server-side only — it must never run in a shopper’s browser. It is wired into this plugin’s package.json and used by tools/webhook-listener.mjs for local webhook testing.

External services

This plugin connects to the AgentaOS payment API to create and verify payments. This connection is required for the gateway to function.

When a customer pays, the plugin sends the following to AgentaOS (https://api.agentaos.ai): the payment amount and currency, an order description, the buyer’s email and name, your store’s success and webhook URLs, and order identifiers (order id and order key). AgentaOS returns a hosted checkout URL, and the customer is redirected there to complete payment. AgentaOS then notifies your store of the result via a signed webhook and/or when the customer returns.

No data is sent unless a customer initiates a payment with this gateway. The plugin loads no third-party scripts on your site.

• Service: AgentaOS — https://agentaos.ai
• Terms of Service: https://agentaos.ai/terms
• Privacy Policy: https://agentaos.ai/privacy