AgentaOS Pay adds an AgentaOS payment gateway to WooCommerce for selling digital goods.<\/p>\n\n
Important: digital goods only.<\/strong> 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.<\/p>\n\n 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 This plugin connects to the AgentaOS payment API to create and verify payments. This connection is required for the gateway to function.<\/p>\n\n 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.<\/p>\n\n No data is sent unless a customer initiates a payment with this gateway. The plugin loads no third-party scripts on your site.<\/p>\n\n In production, yes \u2014 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.<\/p><\/dd>\n Each checkout session is created with an idempotency key derived from the order id and total.<\/p><\/dd>\n AgentaOS only accepts EUR, USD, EURC, EURe and USDC. If your store uses another currency, set a Settlement currency<\/strong> and a Conversion rate<\/strong> 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.<\/p><\/dd>\n 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<\/strong> 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.<\/p><\/dd>\n\n<\/dl>\n\n\n\n
Architecture note: the @agentaos\/pay npm package<\/h4>\n\n
@agentaos\/pay<\/code> Node SDK holds a secret<\/strong> key and is therefore server-side only \u2014 it must never run in a shopper's browser. It is wired into this plugin's package.json<\/code> and used by tools\/webhook-listener.mjs<\/code> for local webhook testing.<\/p>\n\nExternal services<\/h3>\n\n
\n
\n
digital-goods-payments-for-agentaos<\/code> folder to \/wp-content\/plugins\/<\/code> and activate it.<\/li>\n\n
sk_test_<\/code>.<\/li>\nsk_live_<\/code>.<\/li>\n<\/ul><\/li>\n\/wp-json\/agentaos\/v1\/webhook<\/code>), subscribe to checkout.session.completed<\/code>, and paste the signing secret (whsec_...<\/code>) into the matching field.<\/li>\n\n
Does the webhook need to be reachable for orders to complete?<\/h3><\/dt>\n
How are duplicate charges avoided?<\/h3><\/dt>\n
My store currency is not EUR\/USD \u2014 can I still use AgentaOS?<\/h3><\/dt>\n
How do refunds work?<\/h3><\/dt>\n
1.0.0<\/h4>\n\n
\n