Receive payments directly to your wallet without any intermediaries.<\/li>\n<\/ul>\n\nHow do I know if my XRP account is setup correctly?<\/h4>\n\n
The best way is to configure the plugin to use the testnet and make a test payment.<\/p>\n\n
Test Payments<\/h3>\n\n
To test the plugin, you can configure it to use the XRP Ledger Testnet. This allows you to simulate transactions without using real funds. Follow these steps:\n1. Go to the plugin settings in WooCommerce.\n2. Enable the Testnet mode.\n3. Use a XRP Ledger test account to make test payments.\n5. You can create test account from https:\/\/xrpl.org\/xrp-testnet-faucet.html for XRP or https:\/\/tryrlusd.com\/ for RLUSD.<\/p>\n\n
External services<\/h3>\n\n
LedgerDirect uses public APIs from Coinbase, Coingecko, Binance, and Kraken to retrieve current cryptocurrency exchange rates. These rates are needed to correctly calculate and display payments.<\/p>\n\n
No personal or payment data is sent to these services. Only requests for current rates are made when a payment is processed or displayed.<\/p>\n\n
For more information about each service, see:\n- Coinbase API: Terms of Service<\/a>, Privacy Policy<\/a>\n- Coingecko API: Terms of Service<\/a>, Privacy Policy<\/a>\n- Binance API: Terms of Use<\/a>, Privacy Policy<\/a>\n- Kraken API: Terms of Service<\/a>, Privacy Policy<\/a><\/p>\n\nSource Code of minified assets<\/h3>\n\n
LedgerDirect uses minified assets for the WooCommerce blocks checkout. The source for includes\/assets\/js\/frontend\/blocks.asset.js is available at https:\/\/github.com\/ledger-direct\/ledger-direct-woocommerce\/blob\/main\/resources\/js\/frontend\/index.js.<\/p>\n\n
LedgerDirect uses minified assets from third party libraries. The source for the QR code library (jquery-qrcode.min.js) is available at https:\/\/github.com\/jeromeetienne\/jquery-qrcode.<\/p>\n\n\n
Minimum Requirements<\/h4>\n\n\n- PHP version 8.2 or greater<\/li>\n
- WordPress 6.7 or greater<\/li>\n
- WooCommerce 8.6.1 or greater<\/li>\n<\/ul>\n\n
Automatic installation<\/h4>\n\n\n- Search for LedgerDirect plugin in the plugin section of your admin panel.<\/li>\n
- Activate the plugin.<\/li>\n
- Go to WooCommerce -> Settings -> Payments and enable the LedgerDirect gateway to manage the plugin settings.<\/li>\n
- Configure the plugin settings, including your XRP Ledger account details and the currencies you want to<\/li>\n<\/ol>\n\n
Manual installation<\/h4>\n\n\n- Clone the repo from https:\/\/github.com\/ledger-direct\/ledger-direct-woocommerce into the 'plugins' directory.<\/li>\n
- Run 'composer install --no-dev --no-scripts --optimize-autoloader' to install the composer dependencies.<\/li>\n
- Activate the plugin.<\/li>\n
- Go to WooCommerce -> Settings -> Payments and enable the LedgerDirect gateway to manage the plugin settings.<\/li>\n
- Configure the plugin settings, including your XRP Ledger account details and the currencies you want to accept.<\/li>\n<\/ol>\n\n\n
1.2.0<\/h4>\n\n\n- The payment page now follows the payment on its own: it polls every 8 seconds and shows one of five states - waiting (with a countdown for the quote), partial payment, payment in the wrong token, expired quote, and paid - and leaves for the order confirmation as soon as the order is paid or closed. No more reloading.<\/li>\n
- New status endpoint
\/wp-json\/ledger-direct\/v1\/payment-status\/<order key><\/code>, the same payload as every other LedgerDirect plugin. Access is by the order key, as on the \"Order received\" page, so guest orders work without a login.<\/li>\n- The ledger is synced at most once per five seconds per receiving account, however many customers are waiting; the background job is unaffected.<\/li>\n
- An expired quote is no longer replaced silently on reload; the page says so and offers an updated amount on request.<\/li>\n
- Whether a payment is in the wrong token is decided by the shared library, the same rule as on every other platform.<\/li>\n<\/ul>\n\n
1.1.1<\/h4>\n\n\n- Fix: an order that received a partial payment could never be completed. The first payment was recorded and the plugin stopped looking, so a customer who then sent the remaining amount was never marked as paid, neither on the payment page nor by the background job. Payments in the quoted asset now add up, and the order is matched until it settles.<\/li>\n
- Fix: a payment in the right stablecoin from another issuer no longer blocks a later payment from the correct issuer.<\/li>\n
- Core 0.7: the shared library is now required at ^0.7.<\/li>\n
- Release build: a developer document that had been copied into the bundled library was shipped with 1.1.0; it is removed, and the build now refuses to ship such files.<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n\n- Core 0.4: the sync cursor is now kept per receiving account and network. A mainnet transaction can no longer stall the testnet sync, and a testnet reset no longer requires cleaning the database - the plugin resyncs on its own.<\/li>\n
- Core 0.3: when several transactions carry the same destination tag, the newest one in the quoted asset is used. A stray payment in another asset no longer blocks settlement of the real one.<\/li>\n
- Database schema version 3:
network<\/code> column on the transactions table, backfilled from the CTID; migrates automatically on the first request after the update.<\/li>\n<\/ul>\n\n1.0.0<\/h4>\n\n\n- The plugin is now an adapter over the shared
hardcastle\/ledger-direct-core<\/code> library, so prices, exchange rates, destination tags, transaction sync and the settlement decision are identical across all LedgerDirect plugins.<\/li>\n- Fix: XRP payments were only accepted when the delivered amount was at or below the requested amount. Overpayment now settles, and a shortfall of up to 0.15 % is tolerated, as in every other LedgerDirect plugin.<\/li>\n
- Fix: stablecoin payments were compared as raw arrays; a payment from another issuer is now always rejected and an overpayment accepted.<\/li>\n
- Fix: the RLUSD and USDC switches were wired to the wrong asset depending on the network.<\/li>\n
- Fix: the quote expiry setting was ignored (every quote lasted 15 hours). Quotes now expire as configured and are refreshed in place on the payment page, keeping the same destination tag.<\/li>\n
- New: orders are settled in the background every five minutes via Action Scheduler, so a customer who closes the payment page still gets their order marked paid.<\/li>\n
- New: the payment page shows how much of the requested amount has arrived and what is still missing.<\/li>\n
- New: exchange rates are cached briefly (60 s) so a checkout render no longer waits for three price oracles.<\/li>\n
- Database schema version 2: numeric ledger index, per-account destination-tag counter; migrates automatically on the first request after the update.<\/li>\n
- Requires PHP 8.2.<\/li>\n<\/ul>\n\n
0.11.0<\/h4>\n\n\n- Fix: the destination-tag table existed under three different names across install.php and XrplTxService, so reserved destination tags were silently never persisted on fresh installs. Unified to
ledger_direct_xrpl_destination_tag<\/code>, with an automatic upgrade routine for existing installs.<\/li>\n- Fix: add a unique constraint on the transactions table's
hash<\/code> column to enforce deduplication at the database level.<\/li>\n- Fix: KrakenOracle only ever returned a price for the XRP\/USD pair (it read a hardcoded response key); it now reads any pair generically.<\/li>\n
- Fix: price oracle failures are now logged instead of silently discarded, to make pricing issues diagnosable.<\/li>\n
- Fix: the \"change payment method\" AJAX action always failed due to a typo reading the wrong POST field.<\/li>\n
- Add: order pricing metadata now includes
base_asset<\/code> and quote_currency<\/code> fields alongside the existing pairing<\/code>\/exchange_rate<\/code>\/amount_requested<\/code>.<\/li>\n- Remove: the unused, always-returns-zero RippleOracle.<\/li>\n
- Internal: added automated tests, a CI pipeline (lint, coding standards, static analysis, PHPUnit, WordPress Plugin Check), and a WordPress.org SVN release workflow.<\/li>\n<\/ul>","raw_excerpt":"Accept XRP, EUR, USD directly on the XRP Ledger, using LedgerDirect!","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/248462","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=248462"}],"author":[{"embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ledgerdirect"}],"wp:attachment":[{"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=248462"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=248462"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=248462"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=248462"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=248462"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=248462"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}