Description
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
Screenshots
Installation
- Upload the
digital-goods-payments-for-agentaosfolder to/wp-content/plugins/and activate it. - Go to WooCommerce Settings Payments AgentaOS Pay.
- Choose the Environment (Sandbox or Live).
- Paste your secret key(s) from AgentaOS dashboard Settings Developers API Keys:
- Sandbox keys begin with
sk_test_. - Live keys begin with
sk_live_.
- Sandbox keys begin with
- In the AgentaOS dashboard, add a webhook endpoint pointing at the URL shown on the settings screen (
/wp-json/agentaos/v1/webhook), subscribe tocheckout.session.completed, and paste the signing secret (whsec_...) into the matching field. - Enable the gateway and save.
FAQ
-
Does the webhook need to be reachable for orders to complete?
-
In production, yes — configure it. On local environments the plugin also verifies the session server-side when the buyer returns to the thank-you page, so orders still complete without a public webhook URL.
-
How are duplicate charges avoided?
-
Each checkout session is created with an idempotency key derived from the order id and total.
-
My store currency is not EUR/USD — can I still use AgentaOS?
-
AgentaOS only accepts EUR, USD, EURC, EURe and USDC. If your store uses another currency, set a Settlement currency and a Conversion rate on the gateway settings screen. The order total is converted to the settlement currency before it is sent to AgentaOS, the customer is charged that converted amount, and payment confirmation is validated against it. The WooCommerce order stays in your store currency, and a note records the converted amount. If your store already uses a supported currency, no conversion happens.
-
How do refunds work?
-
AgentaOS provides no refund API, so refunds cannot be automated. Issue the refund from your AgentaOS dashboard, then use WooCommerce’s built-in Refund manually button on the order to record it (this keeps stock and reporting accurate; it does not move money). AgentaOS orders show a reminder of this workflow on the order screen.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Digital Goods Payments for AgentaOS” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Digital Goods Payments for AgentaOS” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release.