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