{"id":394139,"date":"2026-11-02T18:49:31","date_gmt":"2026-11-02T18:49:31","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/agentaos-payments-for-woocommerce\/"},"modified":"2026-11-02T19:01:57","modified_gmt":"2026-11-02T19:01:57","slug":"agentaos-payments","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/agentaos-payments\/","author":23594543,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.1.0","stable_tag":"2.1.0","tested":"7.1.4","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"AgentaOS Payments for WooCommerce","header_author":"AgentaOS","header_description":"Take card, Apple Pay and Google Pay payments in WooCommerce through AgentaOS, the merchant of record for AI agents. AgentaOS is the legal seller: it charges each buyer's VAT or sales tax, issues the invoice and pays you to your bank.","assets_banners_color":"cad0d6","last_updated":"2026-11-02 19:01:57","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/agentaos.ai","rating":0,"author_block_rating":0,"active_installs":0,"downloads":54,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"2.0.0":{"tag":"2.0.0","author":"pancheisajeski","date":"2026-11-02 18:48:56","revision":3780519},"2.1.0":{"tag":"2.1.0","author":"pancheisajeski","date":"2026-11-02 19:01:57","revision":3780545}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3780519,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3780519,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3780519,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3780519,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["2.0.0","2.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3780519,"resolution":"1","location":"assets","locale":"","width":1440,"height":1901},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3780519,"resolution":"2","location":"assets","locale":"","width":1440,"height":900},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3780519,"resolution":"3","location":"assets","locale":"","width":1440,"height":900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3780519,"resolution":"4","location":"assets","locale":"","width":1440,"height":900},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3780519,"resolution":"5","location":"assets","locale":"","width":1440,"height":900},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3780519,"resolution":"6","location":"assets","locale":"","width":1280,"height":120}},"screenshots":{"1":"Settings: test and live keys, Get your API keys, Test connection and Connect your AI agent.","2":"A digital product sold as a monthly AgentaOS subscription with a 14-day free trial.","3":"AgentaOS at the WooCommerce checkout.","4":"The customer's subscriptions in My Account, with Cancel at period end.","5":"A paid order: the AgentaOS invoice and the Request AgentaOS refund action.","6":"AgentaOS in the WooCommerce payment providers."}},"plugin_section":[],"plugin_tags":[5472,259732,1887,4079,19126],"plugin_category":[41,45],"plugin_contributors":[290363],"plugin_business_model":[],"class_list":["post-394139","plugin","type-plugin","status-publish","hentry","plugin_tags-digital-products","plugin_tags-merchant-of-record","plugin_tags-payments","plugin_tags-subscriptions","plugin_tags-vat","plugin_category-communication","plugin_category-ecommerce","plugin_contributors-pancheisajeski","plugin_committers-pancheisajeski"],"banners":{"banner":"https:\/\/ps.w.org\/agentaos-payments\/assets\/banner-772x250.png?rev=3780519","banner_2x":"https:\/\/ps.w.org\/agentaos-payments\/assets\/banner-1544x500.png?rev=3780519","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/agentaos-payments\/assets\/icon-128x128.png?rev=3780519","icon_2x":"https:\/\/ps.w.org\/agentaos-payments\/assets\/icon-256x256.png?rev=3780519","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/agentaos-payments\/assets\/screenshot-1.png?rev=3780519","caption":"Settings: test and live keys, Get your API keys, Test connection and Connect your AI agent."},{"src":"https:\/\/ps.w.org\/agentaos-payments\/assets\/screenshot-2.png?rev=3780519","caption":"A digital product sold as a monthly AgentaOS subscription with a 14-day free trial."},{"src":"https:\/\/ps.w.org\/agentaos-payments\/assets\/screenshot-3.png?rev=3780519","caption":"AgentaOS at the WooCommerce checkout."},{"src":"https:\/\/ps.w.org\/agentaos-payments\/assets\/screenshot-4.png?rev=3780519","caption":"The customer's subscriptions in My Account, with Cancel at period end."},{"src":"https:\/\/ps.w.org\/agentaos-payments\/assets\/screenshot-5.png?rev=3780519","caption":"A paid order: the AgentaOS invoice and the Request AgentaOS refund action."},{"src":"https:\/\/ps.w.org\/agentaos-payments\/assets\/screenshot-6.png?rev=3780519","caption":"AgentaOS in the WooCommerce payment providers."}],"raw_content":"<!--section=description-->\n<p>The official AgentaOS plugin for WooCommerce, made and supported by AgentaOS.<\/p>\n\n<p>AgentaOS is the merchant of record for AI agents. It sells on your behalf, so each sale's VAT or sales tax, the buyer's invoice and chargebacks are handled for you, and the money is paid to your own bank account.<\/p>\n\n<p>This plugin adds AgentaOS to WooCommerce. The buyer pays on the secure AgentaOS checkout by card, Apple Pay or Google Pay (or bank transfer for EUR) and comes back to your order confirmation page. Orders are marked paid only when AgentaOS confirms the payment.<\/p>\n\n<p>It works where Stripe and PayPal do not take sellers, including North Macedonia, Serbia, Kosovo, Albania, Bosnia and Herzegovina and Montenegro, and you can sell as an individual: no company is needed.<\/p>\n\n<h4>What you get<\/h4>\n\n<ul>\n<li><strong>Tax handled.<\/strong> AgentaOS is the legal seller of each sale. It adds the buyer's VAT or sales tax at checkout and files it.<\/li>\n<li><strong>Subscriptions built in, no WooCommerce Subscriptions extension needed.<\/strong> Tick \"AgentaOS subscription\" on a product, choose monthly or yearly and an optional free trial. AgentaOS bills every renewal; each renewal appears in WooCommerce as a paid order. Customers see and cancel their subscriptions under My Account.<\/li>\n<li><strong>Your local currency.<\/strong> Stores priced in MKD, RSD, ALL or BAM are charged in EUR (or USD). BAM uses the fixed rate of 1.95583 per euro; for MKD, RSD and ALL you set the rate, and the buyer sees the amount in EUR before paying.<\/li>\n<li><strong>The buyer's invoice on the order.<\/strong> AgentaOS issues the tax invoice as the seller; you, and your customer on their order page and in My Account, can download the paid receipt as a PDF. You do not need an invoice plugin, and should not use one: AgentaOS's invoice is the buyer's tax invoice.<\/li>\n<li><strong>Refunds and disputes on the order.<\/strong> Request a refund from the order screen; the order is marked refunded once AgentaOS has refunded the buyer. Disputes put the order on hold and release it when you win.<\/li>\n<li><strong>Buy now button<\/strong> (optional) on digital product pages, straight to checkout.<\/li>\n<li><strong>AgentaOS and card logos<\/strong> next to the payment method at checkout. An optional \"Powered by AgentaOS\" line, off by default, can be turned on in the settings.<\/li>\n<li><strong>Test and live keys<\/strong> side by side, with a Test connection button.<\/li>\n<li><strong>Paid to your bank,<\/strong> in EUR or USD, twice a month.<\/li>\n<li><strong>Connect your AI agent.<\/strong> AgentaOS is the merchant of record for AI agents. The settings page shows how to connect Claude, ChatGPT or Cursor to your AgentaOS account in a minute, with no key to paste. Then ask in plain language: how many active subscribers you have, who paid this week, or to send a buyer their receipt again.<\/li>\n<\/ul>\n\n<h4>Digital products and digital services<\/h4>\n\n<p>AgentaOS sells productized digital offerings:<\/p>\n\n<ul>\n<li>Software, apps, SaaS, APIs and AI agents<\/li>\n<li>E-books, templates, downloads and digital content<\/li>\n<li>Online courses and memberships<\/li>\n<li>Small standard setup or onboarding packages that come with a digital product<\/li>\n<li>Productized service packages, on AgentaOS accounts approved for them<\/li>\n<\/ul>\n\n<p>Custom or per-client work, and physical or shipped goods, are not allowed under the AgentaOS terms (https:\/\/agentaos.ai\/terms). In WooCommerce, mark digital products as Downloadable and services as Virtual: the payment method only appears when every product in the cart is virtual or downloadable, and the plugin checks the order again before it creates the checkout.<\/p>\n\n<h4>Taxes<\/h4>\n\n<p>AgentaOS adds the buyer's VAT or sales tax at its checkout. Turn off taxes in WooCommerce (Settings, General) so buyers are not charged twice; the plugin warns you while WooCommerce taxes are on.<\/p>\n\n<h4>For developers<\/h4>\n\n<p>Three hooks let you add your own behaviour without changing the plugin:<\/p>\n\n<ul>\n<li><code>agentaos_checkout_body<\/code> (filter): change the request that creates the AgentaOS checkout. Arguments: the request body, the order.<\/li>\n<li><code>agentaos_payment_confirmed<\/code> (action): AgentaOS confirmed a payment and the order is paid. Arguments: the order, the AgentaOS checkout id.<\/li>\n<li><code>agentaos_renewal_created<\/code> (action): a subscription renewal was charged and recorded as a paid order. Arguments: the renewal order, the first order, the event data.<\/li>\n<\/ul>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to the AgentaOS API (https:\/\/api.agentaos.ai), run by Aristokrates O\u00dc (Estonia), to take payments. It sends data only when one of these happens:<\/p>\n\n<ul>\n<li>A buyer places an order with this method: the amount and currency (or the subscription plan), a description with the order number and store name, the buyer's email, name, company and billing country, your store's return, cancel and webhook URLs, and the WooCommerce order ID and order key. AgentaOS uses them to create the checkout, calculate tax and issue the invoice.<\/li>\n<li>The buyer returns to the order confirmation page: the plugin reads that checkout's status.<\/li>\n<li>You save a product marked as an AgentaOS subscription: its name, price, currency, interval, trial length, your webhook URL and the WooCommerce product ID, to create the AgentaOS plan.<\/li>\n<li>A customer cancels a subscription in My Account: the subscription ID.<\/li>\n<li>You request a refund: the sale's transaction ID. Every 6 hours, while refunds or disputes are open, the plugin reads your recent sales' statuses.<\/li>\n<li>You or your customer open an order's invoice: the checkout's status and that invoice's receipt PDF.<\/li>\n<li>You click Test connection: one authenticated read.<\/li>\n<\/ul>\n\n<p>AgentaOS sends payment, renewal, subscription and dispute events (webhooks) to your store.<\/p>\n\n<p>Terms of service: https:\/\/agentaos.ai\/terms\nPrivacy policy: https:\/\/agentaos.ai\/privacy<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin. WooCommerce must be active.<\/li>\n<li>Create a free account at https:\/\/app.agentaos.ai.<\/li>\n<li>In AgentaOS, open Settings, Developers, API Keys and copy a secret key (sk_test_... to try it, sk_live_... for real payments).<\/li>\n<li>In AgentaOS, open Settings, Developers, Webhooks. Set the webhook URL to the address shown in the plugin settings (it ends in \/wp-json\/agentaos\/v1\/webhook), then click Reveal signing secret and copy the whsec_... value.<\/li>\n<li>In WordPress, open WooCommerce, Settings, Payments, AgentaOS. Choose Test or Live, paste the key and secret, tick Enable, save, and click Test connection.<\/li>\n<li>If your store currency is MKD, RSD or ALL, enter the exchange rate.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"is%20this%20the%20official%20agentaos%20plugin%3F\"><h3>Is this the official AgentaOS plugin?<\/h3><\/dt>\n<dd><p>Yes. It is made and supported by AgentaOS (Aristokrates O\u00dc, Estonia). For help, write to contact@agentaos.ai.<\/p><\/dd>\n<dt id=\"do%20i%20need%20a%20company%3F\"><h3>Do I need a company?<\/h3><\/dt>\n<dd><p>Not in most of the countries AgentaOS supports. AgentaOS is the merchant of record, so you can sell as an individual. See https:\/\/agentaos.ai\/countries for your country.<\/p><\/dd>\n<dt id=\"which%20currencies%20can%20my%20store%20use%3F\"><h3>Which currencies can my store use?<\/h3><\/dt>\n<dd><p>EUR and USD are charged as they are. MKD, RSD, ALL and BAM are converted to EUR (or USD for MKD, RSD and ALL). Other store currencies are not supported. A merchant exchange rate stops working 90 days after you save it, so update it at least monthly.<\/p><\/dd>\n<dt id=\"how%20do%20subscriptions%20work%3F\"><h3>How do subscriptions work?<\/h3><\/dt>\n<dd><p>Each subscription product gets a matching AgentaOS plan when you save it. A customer buys one plan per checkout. AgentaOS charges every renewal and sends a signed webhook; the plugin then creates a paid renewal order. If you change the price, interval or trial, new customers get a new plan and existing subscribers keep theirs.<\/p><\/dd>\n<dt id=\"do%20i%20need%20woocommerce%20subscriptions%3F\"><h3>Do I need WooCommerce Subscriptions?<\/h3><\/dt>\n<dd><p>You do not need the WooCommerce Subscriptions extension: subscriptions are built into this plugin and billed by AgentaOS. They are on by default. Untick Subscriptions in the plugin settings to hide the \"AgentaOS subscription\" option; existing subscribers keep renewing and can still cancel.<\/p><\/dd>\n<dt id=\"does%20my%20store%20need%20https%3F\"><h3>Does my store need HTTPS?<\/h3><\/dt>\n<dd><p>Yes. AgentaOS only sends buyers back to secure (https:\/\/) addresses, so a store on plain http:\/\/ cannot take payments; the plugin settings show a warning. Most hosts turn on HTTPS for free.<\/p><\/dd>\n<dt id=\"can%20i%20test%20on%20my%20own%20computer%3F\"><h3>Can I test on my own computer?<\/h3><\/dt>\n<dd><p>Yes, with a test key (sk_test_...) and the test card 4242 4242 4242 4242. Because AgentaOS needs an https address it can reach, give your local site a public https address with a tunnel such as Cloudflare Tunnel or ngrok, and use that address as the WordPress site address while you test.<\/p><\/dd>\n<dt id=\"how%20do%20refunds%20work%3F\"><h3>How do refunds work?<\/h3><\/dt>\n<dd><p>AgentaOS refunds the full amount, VAT included, after a short review (usually the same day, at most 2 business days). Use the order action \"Request AgentaOS refund\"; the plugin checks every 6 hours and records the refund in WooCommerce once AgentaOS has made it.<\/p><\/dd>\n<dt id=\"how%20is%20an%20order%20marked%20as%20paid%3F\"><h3>How is an order marked as paid?<\/h3><\/dt>\n<dd><p>AgentaOS sends a signed webhook to your store. The plugin checks the signature with your webhook secret, the amount, the currency and the order, then marks the order paid. If the buyer reaches the confirmation page first, the plugin also asks AgentaOS for the payment status.<\/p><\/dd>\n<dt id=\"can%20my%20ai%20agent%20set%20this%20up%3F\"><h3>Can my AI agent set this up?<\/h3><\/dt>\n<dd><p>Partly. With the AgentaOS MCP server connected to Claude, ChatGPT or Cursor, your agent can answer questions about your sales, subscribers and receipts, and manage your AgentaOS account; you paste the API key and webhook secret into WooCommerce yourself. The settings page shows how to connect it. See https:\/\/docs.agentaos.ai\/mcp\/setup.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.1.0<\/h4>\n\n<ul>\n<li>Checkout style \"Over your store\": the AgentaOS checkout opens over your store instead of on a new page. If your site is not yet approved in AgentaOS, buyers go to the hosted checkout as before.<\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>Subscriptions billed by AgentaOS, with renewal orders and a Subscriptions page in My Account.<\/li>\n<li>Stores in MKD, RSD, ALL and BAM, charged in EUR or USD.<\/li>\n<li>Refund requests from the order screen; disputes hold the order.<\/li>\n<li>Test and live keys, Test connection button, webhook health check.<\/li>\n<li>Subscriptions can be turned off in the settings; existing subscribers keep renewing.<\/li>\n<li>The buyer's AgentaOS invoice (receipt PDF) on the order screen, the order page and My Account.<\/li>\n<li>Connect your AI agent: setup for Claude, ChatGPT, Cursor and Claude Code on the settings page.<\/li>\n<li>Developer hooks: agentaos_checkout_body, agentaos_payment_confirmed, agentaos_renewal_created.<\/li>\n<li>Warning when the store is not on HTTPS.<\/li>\n<li>Optional Buy now button.<\/li>\n<li>AgentaOS, Visa and Mastercard logos at checkout; optional \"Powered by AgentaOS\" link (off by default).<\/li>\n<li>Retries when the AgentaOS API has a brief outage, without duplicate checkouts.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Digital products and digital services only, checked in the cart and again before checkout.<\/li>\n<li>Accepts a payment that includes the buyer's VAT on top of the order total.<\/li>\n<li>Warning when WooCommerce taxes are on.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release: hosted checkout, signed webhooks, block checkout and HPOS support.<\/li>\n<\/ul>","raw_excerpt":"Sell digital products and subscriptions through AgentaOS, the merchant of record for AI agents. VAT, invoices and bank payouts handled.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/394139","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=394139"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/pancheisajeski"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=394139"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=394139"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=394139"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=394139"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=394139"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=394139"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}