Linux 软件免费装
Banner图

Digital Goods Payments for AgentaOS

开发者 milemilosheski
更新时间 2026年8月21日 16:31
PHP版本: 7.4 及以上
WordPress版本: 7.0
版权: GPLv2 or later
版权网址: 版权信息

标签

woocommerce checkout payments digital goods agentaos

下载

1.0.0

详情介绍:

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. 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.

安装:

  1. Upload the digital-goods-payments-for-agentaos folder to /wp-content/plugins/ and activate it.
  2. Go to WooCommerce → Settings → Payments → AgentaOS Pay.
  3. Choose the Environment (Sandbox or Live).
  4. Paste your secret key(s) from AgentaOS dashboard → Settings → Developers → API Keys:
  5. Sandbox keys begin with sk_test_.
  6. Live keys begin with sk_live_.
  7. In the AgentaOS dashboard, add a webhook endpoint pointing at the URL shown on the settings screen (/wp-json/agentaos/v1/webhook), subscribe to checkout.session.completed, and paste the signing secret (whsec_...) into the matching field.
  8. Enable the gateway and save.

常见问题:

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.

更新日志:

1.0.0