REAL8 Gateway

REAL8 Gateway is built for REAL8, the Stellar asset of the REAL8 Project. This version accepts REAL8 only. REAL8 Gateway adds a REAL8 payment method to WooCommerce's classic checkout and Checkout block. Customers send REAL8 directly to the merchant's public Stellar address with a unique text memo. WordPress verifies the transaction using Stellar Horizon and marks the WooCommerce order paid. Requirements: WooCommerce 8.3 or later, a USD or EUR store, and a funded Stellar mainnet account with a REAL8 trustline. This plugin does not hold funds or ask for private keys. Refunds are handled manually in the merchant's wallet; recording a WooCommerce refund does not send tokens. Features include a configurable payment window, price buffer, bounded underpayment tolerance, optional REAL8 price equivalents, local QR codes and payment instructions in order emails. High-Performance Order Storage is supported. New quotes require a valid price; an unavailable pricing service does not use a hardcoded or indefinitely stale rate. Customers can pay with any Stellar wallet that supports REAL8 and text memos. The REAL8 Wallet link is optional for customers. Hosted payment-intent redirects are disabled by default and require a separately configured service credential. Source and development documentation: https://github.com/REAL8-crypto/real8-gateway External services Enabling and configuring REAL8 Payments authorizes the price and blockchain requests described below. Activation alone does not request prices, validate a wallet or contact an update service. Network providers receive the sending server's IP address and HTTP request metadata, including the WordPress version and site URL in the default HTTP User-Agent. Wallet visits expose the customer's IP address and browser metadata to the wallet provider. REAL8 pricing API (api.real8.org)

• Purpose: fetch current REAL8/USD prices from https://api.real8.org/prices.
• When: payment quotes and enabled shop price equivalents, cached for 60 seconds.
• Sent: a price request; no customer name, email, billing address or order access key is sent for pricing.
• No account or API key is needed for price requests. A network connection is required.
• Service documentation: https://api.real8.org/
• Terms: https://real8.org/en/terms-of-service/
• Privacy: https://real8.org/en/privacy-policy/ Stellar Horizon (horizon.stellar.org)
• Purpose: validate the configured merchant wallet, verify incoming payments and, in EUR stores, read the euro rate from the EURC/USDC order book (Circle's EURC and USDC).
• When: after a public address has been saved in settings, every minute while payments await verification, during customer payment status checks, and for EUR quotes and price equivalents (rate cached for 60 seconds).
• Sent: merchant public Stellar address, transaction hashes and pagination parameters. Order-book requests carry only the two asset codes and issuers.
• No account or API key is required. Transaction data, addresses and text memos on Stellar are public and permanent.
• Documentation: https://developers.stellar.org/docs/data/apis/horizon
• Terms: https://stellar.org/terms-of-service
• Privacy: https://stellar.org/privacy-policy REAL8 Wallet (app.real8.org)
• Purpose: an optional customer-facing wallet page with payment details prefilled.
• When: a customer clicks or scans the wallet link, or when the merchant separately enables hosted payment-intent redirects.
• A direct wallet link sends the public destination address, token amount, asset code and text memo in URL parameters. It does not send the WooCommerce order key.
• Hosted intents: only with the opt-in setting and REAL8_PAYMENT_INTENT_SECRET in wp-config.php, WordPress sends the order ID, token and USD amounts, asset code and issuer, public destination, memo, expiry and return URL INCLUDING the WooCommerce order access key to https://api.real8.org/payment-intents. It reports the intent ID and transaction hash to /payment-intents/{id}/paid after confirmation. These details are available to the hosted service; the return URL grants access to the order. No customer name, email or billing address is explicitly included.
• Customers need a funded Stellar wallet holding REAL8 to send payment. Merchants without a hosted-service credential can use the complete local instruction flow.
• Terms: https://real8.org/en/terms-of-service/
• Privacy: https://real8.org/en/privacy-policy/

Privacy and stored data The plugin stores payment records in the site's database: order ID, memo, expected amount, price, public address, expiry, status and transaction hash. Transaction claims prevent reuse and remain when a payment is retried. Order metadata and notes also contain payment amounts, public sender addresses and transaction details. Operational events are recorded in WooCommerce logs. Deactivation and removal retain financial records for reconciliation. Merchants manage their retention through their database and WooCommerce retention tools; the plugin does not erase blockchain records.

4.7.0

• EUR stores are supported next to USD. A EUR order total is converted with the EURC/USDC order book on Stellar; REAL8 equivalents in the shop use the same rate.
• Hosted wallet intents for EUR orders carry the USD value of the quote.

4.6.2

• Removed the WooCommerce-missing admin notice; WordPress enforces the dependency through the plugin header.
• Translation files are no longer bundled; translations come from translate.wordpress.org.

4.6.1

• Plugin renamed to REAL8 Gateway.

4.6.0

• WordPress.org package, dependency metadata, license notices and service disclosures.
• Native Checkout block integration and removal of the external plugin updater.
• Explicit opt-in for hosted payment-intent redirects.
• Hardened payment destinations, transaction claims, quote handling and final verification.
• Existing stores that used the hosted wallet redirect keep it after upgrading.

4.5.4

• Repair confirmed payments whose WooCommerce orders were not completed.
• Guard expiry writes against concurrent confirmations.