=== SaturnShift for WooCommerce ===
Contributors: saturnshift
Tags: payments, cryptocurrency, usdc, ach, stablecoin
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept cards, ACH, USDC and USDT through SaturnShift. Checkout, refunds and reporting all live in your SaturnShift dashboard.

== Description ==

SaturnShift for WooCommerce is a connector, not a second dashboard. It links your
store to your SaturnShift account and then stays out of the way:

* **Connect once, no keys.** Click "Connect with SaturnShift", approve, and the
  plugin pulls your enabled payment methods (cards, ACH, USDC, USDT), branding
  and surcharge rules, and registers its webhook automatically. There are no API
  keys or secrets to copy.
* **Same checkout.** At "Place Order" the buyer is sent to your hosted SaturnShift
  checkout, the exact one you already use, then returned to your order page.
* **Orders stay in sync.** Signed webhooks move each order between Pending, Paid,
  Failed, Expired and Refunded.
* **On-chain receipt.** Crypto orders show the settlement network and a block
  explorer link on the order, in "My Account", and in order emails.
* **Manage everything in SaturnShift.** Refunds, reporting, invoices, settlements,
  payment links, analytics and customers all live in your SaturnShift dashboard.

You need a SaturnShift account to use this plugin. You can create one for free
during the connect step if you don't have one yet.

== External services ==

This plugin connects your store to SaturnShift, a third-party payment service, to
create checkouts, keep orders in sync, and process refunds. It cannot function
without this connection. The following describes what is sent and when.

**SaturnShift API (https://api.saturnshift.io)**

Used server-to-server for all payment operations.

* When a customer places an order, the plugin sends the order amount, currency,
  order id and your store's return URLs to create a hosted checkout.
* On connect, the plugin registers a webhook URL on your store and fetches your
  merchant configuration (enabled payment methods, branding, surcharge rules).
* When you issue a refund, the plugin sends the order reference and refund amount.
* SaturnShift sends signed webhooks back to your store to update order status.

No customer payment card numbers or bank details pass through your WordPress site;
those are entered directly on SaturnShift's hosted checkout.

**SaturnShift authorization (https://app.saturnshift.io)**

When you click "Connect with SaturnShift", your browser is redirected to
app.saturnshift.io to sign in and approve the connection (OAuth 2.0 with PKCE).
No credentials are entered into or stored by WordPress.

Terms of Service: https://www.saturnshift.io/terms
Privacy Policy: https://www.saturnshift.io/privacy

== Installation ==

1. Upload the plugin to `/wp-content/plugins/` and activate it (or install it from
   the WordPress plugin directory). WooCommerce must be installed and active.
2. Go to WooCommerce > Settings > Payments > SaturnShift.
3. Click "Connect with SaturnShift". Sign in (or create a free account), choose a
   plan if prompted, and approve. You're returned to WooCommerce connected, your
   config is pulled in, and the webhook is registered automatically.
4. The gateway is enabled on connect. Adjust the title/description if you like.

== Frequently Asked Questions ==

= Do I need API keys? =
No. Connecting uses a one-click OAuth approval (the same pattern as "Sign in with"
buttons). There are no keys or secrets to copy or store.

= Do I configure payment methods here? =
No. Whatever you enable in SaturnShift (cards, ACH, USDC, USDT) is what shows at
checkout. The plugin mirrors your SaturnShift configuration.

= Which currencies are supported? =
Orders are settled in USD. If your store currency isn't supported, the plugin
shows a notice and hides itself at checkout until you switch to a supported one.

= Where do I issue refunds? =
You can click Refund on the WooCommerce order, which forwards the request to
SaturnShift, or refund directly in your SaturnShift dashboard. Either way the
WooCommerce order is updated to Refunded when the refund settles.

= Is customer card or bank data stored in WordPress? =
No. Payment details are entered on SaturnShift's hosted checkout, never on your
WordPress site.

= Does it work with the block-based checkout? =
Yes. The plugin supports both the classic and block (Cart & Checkout blocks)
checkout experiences, and is compatible with High-Performance Order Storage.

== Screenshots ==

1. The one-click "Connect with SaturnShift" panel in WooCommerce payment settings.
2. Connected state showing the enabled payment methods pulled from SaturnShift.
3. On-chain payment receipt with a block explorer link on the order-received page.

== Changelog ==

= 1.0.0 =
* Initial release: one-click Connect (OAuth + PKCE, no keys), hosted checkout
  redirect, order sync via signed webhooks, refunds from WooCommerce, on-chain
  receipts, block checkout and HPOS support.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
