{"id":343130,"date":"2026-08-08T19:10:49","date_gmt":"2026-08-08T19:10:49","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/paycrypto-me-for-woocommerce\/"},"modified":"2026-08-08T19:10:31","modified_gmt":"2026-08-08T19:10:31","slug":"paycrypto-me-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/paycrypto-me-for-woocommerce\/","author":23533349,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.1.0","stable_tag":"0.1.0","tested":"7.0.3","requires":"6.5","requires_php":"8.1","requires_plugins":null,"header_name":"PayCrypto.Me for WooCommerce","header_author":"PayCrypto.Me","header_description":"PayCrypto.Me for WooCommerce lets your store accept Bitcoin payments \u2014 On-Chain and Lightning Network \u2014 directly into wallets and nodes you control.","assets_banners_color":"c8c8c9","last_updated":"2026-08-08 19:10:31","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/paycrypto.me\/","header_plugin_uri":"https:\/\/github.com\/paycrypto-me\/paycrypto-me-for-woocommerce","header_author_uri":"https:\/\/paycrypto.me\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":51,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.1.0":{"tag":"0.1.0","author":"paycryptome","date":"2026-08-08 19:10:31"}},"upgrade_notice":{"0.1.0":"<p>Initial release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3638906,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3638906,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3638906,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3638906,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3638906,"resolution":"1","location":"assets","locale":"","width":1280,"height":800},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3638906,"resolution":"2","location":"assets","locale":"","width":1000,"height":1150},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3638906,"resolution":"3","location":"assets","locale":"","width":1280,"height":920},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3638906,"resolution":"4","location":"assets","locale":"","width":1280,"height":800},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3638906,"resolution":"5","location":"assets","locale":"","width":1488,"height":1750},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3638906,"resolution":"6","location":"assets","locale":"","width":1488,"height":2049}},"screenshots":{"1":"Checkout page with the Bitcoin On-Chain and Lightning payment options","2":"Thank you \/ order-received page showing the payment QR code and address","3":"Admin order screen showing the same payment details for support and reconciliation","4":"WooCommerce \u2192 Settings \u2192 Payments listing both PayCrypto.Me gateways","5":"Bitcoin On-Chain gateway settings (network, xPub, timeout, confirmations)","6":"Bitcoin Lightning gateway settings (node type, connection details, test connection button)"}},"plugin_section":[],"plugin_tags":[1886,21057,158202,1887,286],"plugin_category":[45],"plugin_contributors":[274869,274868],"plugin_business_model":[],"class_list":["post-343130","plugin","type-plugin","status-publish","hentry","plugin_tags-bitcoin","plugin_tags-crypto","plugin_tags-lightning-network","plugin_tags-payments","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-lucasrosa95","plugin_contributors-paycryptome","plugin_committers-paycryptome"],"banners":{"banner":"https:\/\/ps.w.org\/paycrypto-me-for-woocommerce\/assets\/banner-772x250.png?rev=3638906","banner_2x":"https:\/\/ps.w.org\/paycrypto-me-for-woocommerce\/assets\/banner-1544x500.png?rev=3638906","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/paycrypto-me-for-woocommerce\/assets\/icon-128x128.png?rev=3638906","icon_2x":"https:\/\/ps.w.org\/paycrypto-me-for-woocommerce\/assets\/icon-256x256.png?rev=3638906","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/paycrypto-me-for-woocommerce\/assets\/screenshot-1.png?rev=3638906","caption":"Checkout page with the Bitcoin On-Chain and Lightning payment options"},{"src":"https:\/\/ps.w.org\/paycrypto-me-for-woocommerce\/assets\/screenshot-2.png?rev=3638906","caption":"Thank you \/ order-received page showing the payment QR code and address"},{"src":"https:\/\/ps.w.org\/paycrypto-me-for-woocommerce\/assets\/screenshot-3.png?rev=3638906","caption":"Admin order screen showing the same payment details for support and reconciliation"},{"src":"https:\/\/ps.w.org\/paycrypto-me-for-woocommerce\/assets\/screenshot-4.png?rev=3638906","caption":"WooCommerce \u2192 Settings \u2192 Payments listing both PayCrypto.Me gateways"},{"src":"https:\/\/ps.w.org\/paycrypto-me-for-woocommerce\/assets\/screenshot-5.png?rev=3638906","caption":"Bitcoin On-Chain gateway settings (network, xPub, timeout, confirmations)"},{"src":"https:\/\/ps.w.org\/paycrypto-me-for-woocommerce\/assets\/screenshot-6.png?rev=3638906","caption":"Bitcoin Lightning gateway settings (node type, connection details, test connection button)"}],"raw_content":"<!--section=description-->\n<p>PayCrypto.Me for WooCommerce lets your store accept Bitcoin directly into wallets and nodes you control \u2014 no custodial processor, no third-party API holding your funds, no percentage cut on every sale.<\/p>\n\n<p>Two independent, fully self-hosted payment methods, both included:<\/p>\n\n<p><strong>Bitcoin On-Chain<\/strong>\nGive the plugin an xPub, yPub or zPub (or a single address) and it derives a fresh, never-reused receiving address for every order via standard HD derivation \u2014 your wallet software does the rest. Works on mainnet or testnet, so you can rehearse the full checkout flow with worthless test coins before going live.<\/p>\n\n<p><strong>Bitcoin Lightning Network<\/strong>\nConnect the plugin straight to your own BTCPay Server instance or lnd node (REST API, with macaroon authentication and optional TLS certificate pinning). Invoices are created and shown to the customer in seconds \u2014 ideal for instant, low-fee payments. A built-in \"Test connection\" button in the settings screen confirms your node is reachable before you enable the method.<\/p>\n\n<h4>Built for a modern WooCommerce store<\/h4>\n\n<ul>\n<li><strong>Checkout, your way<\/strong> \u2014 works with both the WooCommerce Blocks (Cart &amp; Checkout) experience and the classic shortcode checkout.<\/li>\n<li><strong>High-Performance Order Storage (HPOS)<\/strong> \u2014 declared and tested compatible with WooCommerce's Custom Order Tables.<\/li>\n<li><strong>Express Payment button<\/strong> \u2014 an optional one-click \"Buy with Bitcoin\" button on the checkout page, with a configurable icon position.<\/li>\n<li><strong>QR code everywhere it matters<\/strong> \u2014 a scannable payment QR (with copy-to-clipboard and \"Open in wallet\" deep link) on the Thank You page, in My Account \u2192 Orders, and on the admin order screen, so both you and the customer always see the same payment details.<\/li>\n<li><strong>Non-custodial by design<\/strong> \u2014 the plugin never takes possession of funds; it only derives addresses and requests invoices from infrastructure you own.<\/li>\n<li><strong>Debug logging<\/strong> \u2014 every payment attempt is logged through the native WooCommerce logger (WooCommerce \u2192 Status \u2192 Logs, source <code>paycrypto_me<\/code>), so troubleshooting a stuck order doesn't require guesswork.<\/li>\n<li><strong>Translation-ready<\/strong> \u2014 text domain <code>paycrypto-me-for-woocommerce<\/code>, with complete translations included for Portuguese (Brazil), Spanish, French, German, Italian, Russian and Chinese (Simplified).<\/li>\n<li><strong>Developer-friendly<\/strong> \u2014 before\/after payment hooks, filters over the invoice arguments sent to BTCPay\/lnd, and a filter over the final payment data, so custom logic can hook in without touching plugin code.<\/li>\n<\/ul>\n\n<h4>What this plugin intentionally does not do<\/h4>\n\n<p>To keep the free plugin simple and auditable, two things are left out on purpose and reserved for an upcoming official premium add-on that plugs into this same base via hooks \u2014 no fork, no code duplication:<\/p>\n\n<ul>\n<li><strong>Automatic payment confirmation.<\/strong> Today, order status is moved forward manually once you've verified the payment yourself (e.g. in your node or block explorer). Automatic confirmation via BTCPay webhooks \/ lnd polling is planned for the premium add-on.<\/li>\n<li><strong>Fiat \u2192 sats conversion.<\/strong> Lightning invoices are currently created as zero-amount (the wallet reads the amount from the invoice itself once the add-on populates it); automatic conversion of the order's fiat total into an exact BTC\/sats amount is also planned for the premium add-on.<\/li>\n<\/ul>\n\n<p>Bitcoin is currently the only supported cryptocurrency (on-chain and Lightning) \u2014 this keeps the codebase small and well-tested rather than spreading support thin across many chains.<\/p>\n\n<h3>Privacy<\/h3>\n\n<p>This plugin stores the following data needed to process Bitcoin payments:<\/p>\n\n<ul>\n<li>Your wallet's extended public key (xPub\/yPub\/zPub) or single receiving address, and every address derived from it, in dedicated database tables (<code>{prefix}paycrypto_me_bitcoin_wallet_xpubkeys<\/code>, <code>{prefix}paycrypto_me_bitcoin_derivation_indexes<\/code>, <code>{prefix}paycrypto_me_bitcoin_transactions_data<\/code>).<\/li>\n<li>Lightning node connection details you provide (BTCPay Server or lnd URL, API key\/macaroon, optional TLS certificate) in the gateway settings (<code>wp_options<\/code>), and every created invoice in <code>{prefix}paycrypto_me_lightning_invoices<\/code>.<\/li>\n<li>No customer personal data beyond what WooCommerce already stores with the order \u2014 the plugin only attaches the payment address\/invoice details as order meta.<\/li>\n<\/ul>\n\n<p>None of this data leaves your WordPress installation: the plugin only talks to your own wallet-derivation logic and to the BTCPay Server\/lnd node you configure, never to a third-party API.<\/p>\n\n<p><strong>On uninstall, both gateways' settings are deleted<\/strong> \u2014 including the Lightning node credentials (API key, macaroon, TLS certificate), so those secrets are not left behind in your database.<\/p>\n\n<p><strong>The payment record tables are deliberately kept<\/strong> (<code>{prefix}paycrypto_me_bitcoin_wallet_xpubkeys<\/code>, <code>{prefix}paycrypto_me_bitcoin_derivation_indexes<\/code>, <code>{prefix}paycrypto_me_bitcoin_transactions_data<\/code>, <code>{prefix}paycrypto_me_lightning_invoices<\/code>), so the payment history of past orders stays intact for accounting and reconciliation after the plugin is removed. Drop them manually (via your database) if you no longer need them.<\/p>\n\n<h3>Support<\/h3>\n\n<p>For support, visit https:\/\/paycrypto.me\/ or open an issue on the plugin's GitHub repository.<\/p>\n\n<h3>Credits<\/h3>\n\n<p>Developed by PayCrypto.Me \u2014 https:\/\/paycrypto.me\/<\/p>\n\n<p>Built with the open-source <code>bitwasp\/bitcoin<\/code> library for HD key derivation and <code>endroid\/qr-code<\/code> for QR code generation.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Make sure WooCommerce is installed and active \u2014 the plugin will show an admin notice and stay inactive otherwise.<\/li>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/<\/code> (or install it via your usual deployment workflow) and activate it from the WordPress Plugins screen.<\/li>\n<li>Go to <strong>WooCommerce \u2192 Settings \u2192 Payments<\/strong> and you'll see two new methods: \"Bitcoin\" (On-Chain) and \"Bitcoin Lightning\". Enable whichever one (or both) you want to accept.<\/li>\n<li><strong>On-Chain:<\/strong> open its settings and paste your xPub\/yPub\/zPub (recommended) or a single receiving address, choose mainnet or testnet, and adjust the payment timeout and number of confirmations required to your risk tolerance.<\/li>\n<li><strong>Lightning:<\/strong> open its settings, choose your node type (BTCPay Server or lnd REST), fill in the connection details (URL, API key\/macaroon, optional TLS certificate), and use the \"Test connection\" button to confirm the plugin can reach it before enabling the method.<\/li>\n<li>Testing: switch the On-Chain gateway to testnet, place a test order and confirm the full flow end to end before going live with mainnet.<\/li>\n<\/ol>\n\n<p>Notes:\n- For troubleshooting, enable debug logging in the gateway settings and check WooCommerce \u2192 Status \u2192 Logs (source <code>paycrypto_me<\/code>).\n- The plugin is not responsible for the data provided or who accesses it \u2014 safeguarding your xPub, API keys and macaroons is the store administrator's responsibility.\n- Only Bitcoin is currently supported (on-chain and Lightning). Support for additional networks may be considered in future updates.\n- Payment confirmation is currently a manual, admin-driven step \u2014 see \"What this plugin intentionally does not do\" above.\n- <strong>PHP extensions:<\/strong> the Bitcoin On-Chain gateway requires the <code>gmp<\/code> extension to derive addresses \u2014 without it, On-Chain is hidden from checkout (with an admin notice) but Lightning keeps working normally. The payment QR code requires <code>gd<\/code>; if it's missing, the order-details page still shows the address\/invoice and a copy button, just without the QR image.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"which%20cryptocurrencies%20are%20supported%3F\"><h3>Which cryptocurrencies are supported?<\/h3><\/dt>\n<dd><p>Bitcoin only, through two independent methods: On-Chain (mainnet\/testnet, address derived from your xPub\/yPub\/zPub) and Lightning Network (via your own BTCPay Server or lnd node).<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20take%20custody%20of%20my%20funds%20at%20any%20point%3F\"><h3>Does the plugin take custody of my funds at any point?<\/h3><\/dt>\n<dd><p>No. On-Chain payments go straight to addresses derived from your own extended public key; Lightning invoices are created and settled directly by your own BTCPay Server or lnd node. The plugin never holds keys or funds.<\/p><\/dd>\n<dt id=\"can%20i%20run%20both%20on-chain%20and%20lightning%20at%20the%20same%20time%3F\"><h3>Can I run both On-Chain and Lightning at the same time?<\/h3><\/dt>\n<dd><p>Yes \u2014 enable both gateways and customers choose whichever they prefer at checkout.<\/p><\/dd>\n<dt id=\"do%20i%20need%20to%20run%20my%20own%20lightning%20node%3F\"><h3>Do I need to run my own Lightning node?<\/h3><\/dt>\n<dd><p>Yes, you need access to a BTCPay Server instance or an lnd node with its REST API reachable from your WordPress host. The plugin is a client to infrastructure you already run or control.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20woocommerce%20blocks%20checkout%3F\"><h3>Does it work with WooCommerce Blocks checkout?<\/h3><\/dt>\n<dd><p>Yes, both gateways support the Blocks-based Cart &amp; Checkout as well as the classic shortcode checkout, and both declare compatibility with High-Performance Order Storage (HPOS).<\/p><\/dd>\n<dt id=\"how%20do%20i%20test%20payments%20safely%20before%20going%20live%3F\"><h3>How do I test payments safely before going live?<\/h3><\/dt>\n<dd><p>Switch the On-Chain gateway's network to testnet and place a test order, or use your Lightning node's own testing\/regtest setup if it supports one \u2014 the plugin itself only exposes mainnet\/testnet for On-Chain.<\/p><\/dd>\n<dt id=\"where%20are%20payment%20logs%20stored%3F\"><h3>Where are payment logs stored?<\/h3><\/dt>\n<dd><p>Through the native WooCommerce logger, source <code>paycrypto_me<\/code>. Access them via WooCommerce \u2192 Status \u2192 Logs.<\/p><\/dd>\n<dt id=\"does%20the%20order%20status%20update%20automatically%20once%20the%20customer%20pays%3F\"><h3>Does the order status update automatically once the customer pays?<\/h3><\/dt>\n<dd><p>Not in the free plugin \u2014 see \"What this plugin intentionally does not do\" in the description. Automatic confirmation is planned for a future premium add-on.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Initial public release.<\/li>\n<li>Bitcoin On-Chain gateway: HD address derivation from xPub\/yPub\/zPub, mainnet and testnet, configurable payment timeout and required confirmations.<\/li>\n<li>Bitcoin Lightning gateway: BTCPay Server and lnd REST support, with an in-admin connection tester for each.<\/li>\n<li>WooCommerce Blocks (Cart &amp; Checkout) and classic shortcode checkout support, including an optional Express Payment (\"Buy with Bitcoin\") button.<\/li>\n<li>High-Performance Order Storage (Custom Order Tables) compatibility.<\/li>\n<li>Payment QR code with copy-to-clipboard and \"open in wallet\" link on the Thank You page, My Account and admin order screens.<\/li>\n<li>Debug logging via the WooCommerce logger.<\/li>\n<li>Initial translations for pt_BR, es_ES, fr_FR, de_DE, it_IT, ru_RU and zh_CN.<\/li>\n<li>Developer extension points reserved for the upcoming premium add-on, with no effect on the free plugin: amount-enforced lnd invoices, an on-chain confirmation-tracking hook, order-details display filters, and dedicated on-chain payment filters.<\/li>\n<\/ul>","raw_excerpt":"Self-hosted, non-custodial Bitcoin payments for WooCommerce \u2014 On-Chain (HD wallet) and Lightning Network (BTCPay Server or lnd), no middleman.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/343130","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=343130"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/paycryptome"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=343130"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=343130"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=343130"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=343130"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=343130"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=343130"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}