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.
Frequently Asked Questions
Installation
How do I install REAL8 Gateway?
- Make sure WooCommerce is installed and active.
- Download the plugin ZIP from the GitHub releases page.
- In your WordPress admin, go to Plugins → Add New → Upload Plugin and upload the ZIP.
- Activate the plugin, then go to WooCommerce → Settings → Payments → REAL8 Payment to enable and configure it.
What are the requirements?
WordPress 5.8 or higher, WooCommerce 5.0 or higher, PHP 7.4 or higher, and a Stellar wallet with a REAL8 trustline.Merchant wallet
How do I set up the wallet that receives payments?
- Create a Stellar wallet, for example with the REAL8 wallet, Lobstr, or any other Stellar wallet.
- Fund it with at least 1.5 XLM (Stellar account reserve).
- Add the REAL8 trustline: asset code
REAL8, issuerGBVYYQ7XXRZW6ZCNNCL2X2THNPQ6IM4O47HAA25JTAG7Z3CXJCQ3W4CD. - 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 redirects the customer to the REAL8 wallet (app.real8.org) to complete the payment; in a desktop browser a QR code is shown. If the payment service is unreachable, the plugin falls back to on-page payment instructions with the address, the amount, and the memo to use.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?
REAL8 Gateway checks for new releases automatically every 12 hours and offers updates in Dashboard → Updates like any other plugin. You can also download the latest ZIP from the GitHub releases page and upload it manually.Anything to know when upgrading from 4.3.1 or older?
Since version 4.3.7 the payment-intent flow requires the constantREAL8_PAYMENT_INTENT_SECRET in wp-config.php. Without it the gateway keeps working and falls back to on-page payment instructions; checkout is not blocked. 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.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.