REAL8 Gateway – Support

REAL8 Gateway - Support

Help and FAQs for REAL8 Gateway, the WooCommerce payment gateway for REAL8 token payments on the Stellar blockchain. Browse the FAQ below or use the contact form to reach our team.

WooCommerce Tech Support

Frequently Asked Questions

Installation

How do I install REAL8 Gateway?
  1. Make sure WooCommerce is installed and active.
  2. In your WordPress admin, go to Plugins → Add New, search for “REAL8 Gateway” and click Install Now. The plugin is listed in the WordPress plugin directory; you can also download the ZIP there and upload it under Plugins → Add New → Upload Plugin.
  3. Activate the plugin, then go to WooCommerce → Settings → Payments → REAL8 Payments to enable and configure it.
What are the requirements?WordPress 6.5 or higher, WooCommerce 8.3 or higher, PHP 7.4 or higher, a store currency of USD, and a Stellar wallet with a REAL8 trustline. The gateway is not offered in stores with another currency.

Merchant wallet

How do I set up the wallet that receives payments?
  1. Create a Stellar wallet, for example with the REAL8 wallet, Lobstr, or any other Stellar wallet.
  2. Fund it with at least 1.5 XLM (Stellar account reserve).
  3. Add the REAL8 trustline: asset code REAL8, issuer GBVYYQ7XXRZW6ZCNNCL2X2THNPQ6IM4O47HAA25JTAG7Z3CXJCQ3W4CD.
  4. Enter your public key (it starts with G) as the Merchant Stellar Address in the plugin settings.
The settings page shows a wallet warning. What does it mean?The plugin validates your address and warns when the account does not exist, has no funds, or is missing the REAL8 trustline. Fix the indicated step and reload the settings page: the status updates automatically.

Payments

How does a customer pay with REAL8?The customer selects “Pay with REAL8” at checkout. The plugin converts the order total to REAL8 at the current REAL8/USD rate and shows the payment instructions on the order page: the address, the amount and the memo to use, with a QR code on desktop screens and a copy button for each field. The same details go into the order email. The customer pays from the REAL8 Wallet or any other Stellar wallet that supports text memos. Optionally, the merchant can enable the hosted REAL8 Wallet redirect in the settings, which sends the customer to app.real8.org with every field prefilled; it needs a credential from the REAL8 Project and is off by default.
How is a payment matched to its order?Every order gets a unique memo. The plugin monitors the Stellar network and confirms the order automatically when a payment with that memo arrives at your address.
What about price volatility or slight underpayments?Two settings cover this: a price buffer (default 2%) is added to the quote to absorb volatility, and an underpayment tolerance (maximum 5%) accepts payments that fall marginally short. Since version 4.4.0 the quoted REAL8 amount is also locked per order for 24 hours, so a customer who returns to an abandoned checkout pays the amount originally quoted.
What happens when the payment window expires?Each order shows a live countdown (default: 30 minutes, configurable). If it expires before a payment is detected, the order is not confirmed. The locked amount is kept for 24 hours; after that, a fresh quote replaces it.

Configuration

Which settings are required?Only the Merchant Stellar Address. Everything else has sensible defaults: the method title and description shown at checkout, the payment timeout (30 minutes), the price buffer (2%), and the underpayment tolerance.

Updates

How do I update the plugin?Since version 4.6, updates come from the WordPress plugin directory: WordPress offers them in Dashboard → Updates like any other plugin. You can also download the latest ZIP from the plugin page and upload it manually.
Anything to know when upgrading from 4.5 or older?Version 4.6 no longer updates itself from GitHub; once you are on 4.6 or later, updates arrive from WordPress.org. The hosted REAL8 Wallet redirect became an explicit setting: a store that already had REAL8_PAYMENT_INTENT_SECRET in wp-config.php keeps the redirect on after the upgrade, any other store uses the on-page payment instructions until the merchant enables it. Use the contact form below if you want help setting it up.

Contact Support

Can’t find what you’re looking for? Send us a message and we’ll get back to you within 1–2 business days.
Product Support (EN)

Bug Reports & Feature Requests

For bug reports and feature requests, please use the GitHub issue tracker. Please include your plugin version and the steps to reproduce so we can investigate efficiently.

Shopping Cart