{"id":380792,"date":"2026-10-12T21:46:19","date_gmt":"2026-10-12T21:46:19","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/real8-gateway\/"},"modified":"2026-10-12T22:46:31","modified_gmt":"2026-10-12T22:46:31","slug":"real8-gateway","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/real8-gateway\/","author":23578869,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"4.6.2","stable_tag":"4.6.2","tested":"7.1.3","requires":"6.5","requires_php":"7.4","requires_plugins":null,"header_name":"REAL8 Gateway","header_author":"REAL8","header_description":"Accept REAL8 token payments on the Stellar blockchain for WooCommerce orders","assets_banners_color":"263880","last_updated":"2026-10-12 22:46:31","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/REAL8-crypto\/real8-gateway","header_author_uri":"https:\/\/real8.org","rating":0,"author_block_rating":0,"active_installs":0,"downloads":63,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"4.6.2":{"tag":"4.6.2","author":"real8","date":"2026-10-12 22:46:31","revision":3742584}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3742554,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3742554,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3742545,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3742545,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["4.6.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3742584,"resolution":"1","location":"assets","locale":"","width":1280,"height":1602},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3742584,"resolution":"2","location":"assets","locale":"","width":1280,"height":950},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3742584,"resolution":"3","location":"assets","locale":"","width":1064,"height":1340},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3742584,"resolution":"4","location":"assets","locale":"","width":1280,"height":1030},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3742584,"resolution":"5","location":"assets","locale":"","width":1280,"height":1310},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3742584,"resolution":"6","location":"assets","locale":"","width":1280,"height":1000}},"screenshots":{"1":"Gateway settings: enable the method, enter the public Stellar address and see on the spot whether the account exists, is funded and holds the REAL8 trustline.","2":"Checkout with \"Pay with REAL8\" selected, in the WooCommerce Checkout block.","3":"Payment instructions after placing the order: amount, destination address, unique memo, QR code, countdown and automatic payment check.","4":"Optional REAL8 equivalents next to the USD prices in the shop.","5":"The order in WooCommerce admin with the payment note: quoted amount, price, memo, address and expiry.","6":"REAL8 Payments in the WooCommerce payment providers list."}},"plugin_section":[],"plugin_tags":[1887,286269,66626,286],"plugin_category":[45],"plugin_contributors":[286271,286270],"plugin_business_model":[],"class_list":["post-380792","plugin","type-plugin","status-publish","hentry","plugin_tags-payments","plugin_tags-real8","plugin_tags-stellar","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-prowoos","plugin_contributors-real8","plugin_committers-real8"],"banners":{"banner":"https:\/\/ps.w.org\/real8-gateway\/assets\/banner-772x250.png?rev=3742545","banner_2x":"https:\/\/ps.w.org\/real8-gateway\/assets\/banner-1544x500.png?rev=3742545","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/real8-gateway\/assets\/icon-128x128.png?rev=3742554","icon_2x":"https:\/\/ps.w.org\/real8-gateway\/assets\/icon-256x256.png?rev=3742554","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/real8-gateway\/assets\/screenshot-1.png?rev=3742584","caption":"Gateway settings: enable the method, enter the public Stellar address and see on the spot whether the account exists, is funded and holds the REAL8 trustline."},{"src":"https:\/\/ps.w.org\/real8-gateway\/assets\/screenshot-2.png?rev=3742584","caption":"Checkout with \"Pay with REAL8\" selected, in the WooCommerce Checkout block."},{"src":"https:\/\/ps.w.org\/real8-gateway\/assets\/screenshot-3.png?rev=3742584","caption":"Payment instructions after placing the order: amount, destination address, unique memo, QR code, countdown and automatic payment check."},{"src":"https:\/\/ps.w.org\/real8-gateway\/assets\/screenshot-4.png?rev=3742584","caption":"Optional REAL8 equivalents next to the USD prices in the shop."},{"src":"https:\/\/ps.w.org\/real8-gateway\/assets\/screenshot-5.png?rev=3742584","caption":"The order in WooCommerce admin with the payment note: quoted amount, price, memo, address and expiry."},{"src":"https:\/\/ps.w.org\/real8-gateway\/assets\/screenshot-6.png?rev=3742584","caption":"REAL8 Payments in the WooCommerce payment providers list."}],"raw_content":"<!--section=description-->\n<p>REAL8 Gateway is built for REAL8, the Stellar asset of the REAL8 Project. This version accepts REAL8 only.<\/p>\n\n<p>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.<\/p>\n\n<p>Requirements: WooCommerce 8.3 or later, a USD 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.<\/p>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>Source and development documentation: <a href=\"https:\/\/github.com\/REAL8-crypto\/real8-gateway\">https:\/\/github.com\/REAL8-crypto\/real8-gateway<\/a><\/p>\n\n<h4>External services<\/h4>\n\n<p>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.<\/p>\n\n<p>REAL8 pricing API (<a href=\"https:\/\/api.real8.org\">api.real8.org<\/a>)\n* Purpose: fetch current REAL8\/USD prices from <a href=\"https:\/\/api.real8.org\/prices\">https:\/\/api.real8.org\/prices<\/a>.\n* When: payment quotes and enabled shop price equivalents, cached for 60 seconds.\n* Sent: a price request; no customer name, email, billing address or order access key is sent for pricing.\n* No account or API key is needed for price requests. A network connection is required.\n* Service documentation: <a href=\"https:\/\/api.real8.org\/\">https:\/\/api.real8.org\/<\/a>\n* Terms: <a href=\"https:\/\/real8.org\/en\/terms-of-service\/\">https:\/\/real8.org\/en\/terms-of-service\/<\/a>\n* Privacy: <a href=\"https:\/\/real8.org\/en\/privacy-policy\/\">https:\/\/real8.org\/en\/privacy-policy\/<\/a><\/p>\n\n<p>Stellar Horizon (<a href=\"https:\/\/horizon.stellar.org\">horizon.stellar.org<\/a>)\n* Purpose: validate the configured merchant wallet and verify incoming payments.\n* When: after a public address has been saved in settings, every minute while payments await verification, and during customer payment status checks.\n* Sent: merchant public Stellar address, transaction hashes and pagination parameters. Asset code and issuer may be used for orderbook requests by the legacy token API.\n* No account or API key is required. Transaction data, addresses and text memos on Stellar are public and permanent.\n* Documentation: <a href=\"https:\/\/developers.stellar.org\/docs\/data\/apis\/horizon\">https:\/\/developers.stellar.org\/docs\/data\/apis\/horizon<\/a>\n* Terms: <a href=\"https:\/\/stellar.org\/terms-of-service\">https:\/\/stellar.org\/terms-of-service<\/a>\n* Privacy: <a href=\"https:\/\/stellar.org\/privacy-policy\">https:\/\/stellar.org\/privacy-policy<\/a><\/p>\n\n<p>REAL8 Wallet (<a href=\"https:\/\/app.real8.org\">app.real8.org<\/a>)\n* Purpose: an optional customer-facing wallet page with payment details prefilled.\n* When: a customer clicks or scans the wallet link, or when the merchant separately enables hosted payment-intent redirects.\n* 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.\n* 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 <a href=\"https:\/\/api.real8.org\/payment-intents\">https:\/\/api.real8.org\/payment-intents<\/a>. 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.\n* Customers need a funded Stellar wallet holding REAL8 to send payment. Merchants without a hosted-service credential can use the complete local instruction flow.\n* Terms: <a href=\"https:\/\/real8.org\/en\/terms-of-service\/\">https:\/\/real8.org\/en\/terms-of-service\/<\/a>\n* Privacy: <a href=\"https:\/\/real8.org\/en\/privacy-policy\/\">https:\/\/real8.org\/en\/privacy-policy\/<\/a><\/p>\n\n<h4>Privacy and stored data<\/h4>\n\n<p>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.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate WooCommerce 8.3 or later. Set your store currency to USD.<\/li>\n<li>Upload the plugin ZIP in Plugins &gt; Add New and activate it.<\/li>\n<li>Open WooCommerce &gt; Settings &gt; Payments &gt; REAL8 Payments.<\/li>\n<li>Save your public Stellar address. Add a REAL8 trustline for issuer GBVYYQ7XXRZW6ZCNNCL2X2THNPQ6IM4O47HAA25JTAG7Z3CXJCQ3W4CD using your wallet. Keep enough XLM to meet the network's account and trustline reserves.<\/li>\n<li>Read the external-service disclosure and enable REAL8 Payments.<\/li>\n<li>Confirm that WordPress cron runs regularly. On low-traffic sites, configure a server cron to run WordPress scheduled events.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20work%20in%20currencies%20other%20than%20usd%3F\"><h3>Does this work in currencies other than USD?<\/h3><\/dt>\n<dd><p>No. The gateway and REAL8 price equivalents are disabled for other store currencies. The plugin does not provide foreign-exchange conversion.<\/p><\/dd>\n<dt id=\"do%20i%20need%20a%20real8%20service%20credential%3F\"><h3>Do I need a REAL8 service credential?<\/h3><\/dt>\n<dd><p>No for local payment instructions, prices and Stellar verification. The optional hosted wallet redirect requires REAL8_PAYMENT_INTENT_SECRET in wp-config.php and the hosted redirect checkbox. Obtain service access before configuring this credential; never put a secret in the plugin files.<\/p><\/dd>\n<dt id=\"what%20if%20a%20payment%20is%20late%20or%20verification%20is%20unavailable%3F\"><h3>What if a payment is late or verification is unavailable?<\/h3><\/dt>\n<dd><p>The server checks Horizon before expiring a payment. Network errors leave it pending for verification; if it still cannot be verified a day after its deadline, the order is put on hold with a note for the merchant. Payments sent after an order is expired require merchant reconciliation. A payment for an order whose total, currency or payment method changed after quoting is recorded and held for merchant review. Contact the store with the transaction hash if a payment is not credited. Check cron and WooCommerce &gt; Status &gt; Logs.<\/p><\/dd>\n<dt id=\"are%20subscriptions%20and%20automatic%20refunds%20supported%3F\"><h3>Are subscriptions and automatic refunds supported?<\/h3><\/dt>\n<dd><p>The gateway supports one-time product payments. It does not automatically debit renewals or issue on-chain refunds. Some subscription plugins may permit manual renewal payments; test your combination before use.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>4.6.2<\/h4>\n\n<ul>\n<li>Removed the WooCommerce-missing admin notice; WordPress enforces the dependency through the plugin header.<\/li>\n<li>Translation files are no longer bundled; translations come from translate.wordpress.org.<\/li>\n<\/ul>\n\n<h4>4.6.1<\/h4>\n\n<ul>\n<li>Plugin renamed to REAL8 Gateway.<\/li>\n<\/ul>\n\n<h4>4.6.0<\/h4>\n\n<ul>\n<li>WordPress.org package, dependency metadata, license notices and service disclosures.<\/li>\n<li>Native Checkout block integration and removal of the external plugin updater.<\/li>\n<li>Explicit opt-in for hosted payment-intent redirects.<\/li>\n<li>Hardened payment destinations, transaction claims, quote handling and final verification.<\/li>\n<li>Existing stores that used the hosted wallet redirect keep it after upgrading.<\/li>\n<\/ul>\n\n<h4>4.5.4<\/h4>\n\n<ul>\n<li>Repair confirmed payments whose WooCommerce orders were not completed.<\/li>\n<li>Guard expiry writes against concurrent confirmations.<\/li>\n<\/ul>","raw_excerpt":"Accept REAL8 token payments on Stellar for USD WooCommerce orders, with local payment instructions and automatic verification.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/380792","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=380792"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/real8"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=380792"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=380792"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=380792"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=380792"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=380792"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=380792"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}