{"id":187807,"date":"2024-06-26T11:53:32","date_gmt":"2024-06-26T11:53:32","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/forumpay-payments-for-woocommerce\/"},"modified":"2026-03-17T15:43:43","modified_gmt":"2026-03-17T15:43:43","slug":"forumpay-crypto-payments","status":"publish","type":"plugin","link":"https:\/\/zh-hk.wordpress.org\/plugins\/forumpay-crypto-payments\/","author":21182588,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.4.1","stable_tag":"2.4.1","tested":"6.8.5","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"ForumPay Crypto Payments for WooCommerce","header_author":"ForumPay","header_description":"Accept payments in WooCommerce with the official ForumPay plugin","assets_banners_color":"252525","last_updated":"2026-03-17 15:43:43","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/forumpay.com","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":90,"downloads":2479,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"2.2.0":{"tag":"2.2.0","author":"forumpay","date":"2024-06-26 11:53:13"},"2.2.1":{"tag":"2.2.1","author":"forumpay","date":"2024-07-15 06:53:26"},"2.2.10":{"tag":"2.2.10","author":"forumpay","date":"2025-04-07 09:34:16"},"2.2.2":{"tag":"2.2.2","author":"forumpay","date":"2024-07-26 08:25:42"},"2.2.3":{"tag":"2.2.3","author":"forumpay","date":"2024-07-31 12:45:42"},"2.2.4":{"tag":"2.2.4","author":"forumpay","date":"2024-10-02 13:56:09"},"2.2.5":{"tag":"2.2.5","author":"forumpay","date":"2024-11-04 09:04:42"},"2.2.6":{"tag":"2.2.6","author":"forumpay","date":"2024-11-04 14:37:23"},"2.2.7":{"tag":"2.2.7","author":"forumpay","date":"2024-12-10 15:36:43"},"2.2.8":{"tag":"2.2.8","author":"forumpay","date":"2025-02-03 11:10:25"},"2.2.9":{"tag":"2.2.9","author":"forumpay","date":"2025-02-07 08:37:22"},"2.3.1":{"tag":"2.3.1","author":"forumpay","date":"2026-02-26 14:17:16"},"2.4.0":{"tag":"2.4.0","author":"forumpay","date":"2026-03-17 11:30:52"},"2.4.1":{"tag":"2.4.1","author":"forumpay","date":"2026-03-17 15:43:43"}},"upgrade_notice":{"Using admin panel":"","1. Recommended method \u2013 upgrade via WordPress Plugin Directory":"

Open your admin panel and select Plugins<\/strong> tab. Click Installed Plugins<\/strong>, find the plugin, in the update warning message click on link update now<\/strong>.<\/p>","2. Alternative method \u2013 upgrade by uploading the plugin manually":"

Open your admin panel and select Plugins<\/strong> tab. Click Add New<\/strong> and then Upload Plugin<\/strong>.\nSelect the downloaded ForumPay module .zip file.<\/p>","Manual method (through filesystem):":"

As you already have \/wp-content\/plugins\/forumpay-crypto-payments<\/strong> or \/wp-content\/plugins\/woocommerce-forumpay<\/strong> folder from previous versions, you need to remove them first.\nTransfer the downloaded .zip archive to your server and unzip it, so the forumpay-crypto-payments<\/strong> directory goes into the \/wp-content\/plugins\/<\/strong> directory relative<\/strong> to your Wordpress<\/strong> root.\nDirectory structure should be as follows: \/wp-content\/plugins\/forumpay-crypto-payments<\/strong>.<\/p>\n\n

After the module is installed, go back to the Plugins<\/strong> page and activate it.<\/p>\n\n

Upgrade from previous version<\/strong>\nOpen your admin panel and select Plugins<\/strong> tab. Click Add New<\/strong> and then Upload Plugin<\/strong>.\nSelect the downloaded ForumPay module .zip file.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.jpg":{"filename":"icon-128x128.jpg","revision":3125782,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.jpg":{"filename":"icon-256x256.jpg","revision":3125782,"resolution":"256x256","location":"assets","locale":""},"icon.svg":{"filename":"icon.svg","revision":3125782,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3125782,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3125782,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["2.2.0","2.2.1","2.2.10","2.2.2","2.2.3","2.2.4","2.2.5","2.2.6","2.2.7","2.2.8","2.2.9","2.3.1","2.4.0","2.4.1"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3108057,"resolution":"1","location":"assets","locale":""},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3108057,"resolution":"2","location":"assets","locale":""}},"screenshots":{"1":"Order checkout currency selection","2":"Order checkout wallet QR code"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[12611,1890,507,286],"plugin_category":[45],"plugin_contributors":[228890],"plugin_business_model":[],"class_list":["post-187807","plugin","type-plugin","status-publish","hentry","plugin_tags-cryptocurrency","plugin_tags-gateway","plugin_tags-payment","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-forumpay","plugin_committers-forumpay"],"banners":{"banner":"https:\/\/ps.w.org\/forumpay-crypto-payments\/assets\/banner-772x250.jpg?rev=3125782","banner_2x":"https:\/\/ps.w.org\/forumpay-crypto-payments\/assets\/banner-1544x500.jpg?rev=3125782","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/forumpay-crypto-payments\/assets\/icon.svg?rev=3125782","icon":"https:\/\/ps.w.org\/forumpay-crypto-payments\/assets\/icon.svg?rev=3125782","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/forumpay-crypto-payments\/assets\/screenshot-1.jpg?rev=3108057","caption":"Order checkout currency selection"},{"src":"https:\/\/ps.w.org\/forumpay-crypto-payments\/assets\/screenshot-2.jpg?rev=3108057","caption":"Order checkout wallet QR code"}],"raw_content":"\n

Crypto payment gateway for your business\nAccept any crypto from any wallet and get paid in cash, instantly.<\/p>\n\n

Crypto consumers are one of the fastest growing segments in the world with over 300 million wallets issued to date. Studies show that crypto consumers spend 2x AOV of a typical credit card consumer and that 40% are in fact new customers. Crypto is more efficient than traditional payment methods as there are less parties involved in a payment process.<\/p>\n\n

Key Features:<\/strong>\n* Accept 100+ cryptocurrencies\n* Instant payment processing with zero confirmation options\n* Automatic order status updates via webhooks\n* Sandbox testing environment\n* Comprehensive payment handling (underpayment\/overpayment)\n* WooCommerce 6.2+ compatibility<\/p>\n\n\n

Using admin panel<\/h3>\n\n

1. Recommended method \u2013 install via WordPress Plugin Directory<\/h4>\n\n

Open your admin panel and select Plugins<\/strong> tab. Click Add New<\/strong> and then search for ForumPay Crypto Payments for WooCommerce<\/strong>.\nThen click the Install Now<\/strong> button. After the installation is complete, click the Activate<\/strong> button.<\/p>\n\n

2. Alternative method \u2013 install by uploading the plugin manually<\/h4>\n\n

Open your admin panel and select Plugins<\/strong> tab. Click Add New<\/strong> and then Upload Plugin<\/strong>.\nSelect the downloaded ForumPay module .zip file and upload it, find the plugin in the list, click Install Now<\/strong>, and then click Activate<\/strong> to enable it.<\/p>\n\n

Manual method (through filesystem):<\/h3>\n\n

Transfer the downloaded .zip archive to your server and unzip it, so the forumpay-crypto-payments<\/strong> directory goes into the \/wp-content\/plugins\/<\/strong> directory relative<\/strong> to your WordPress<\/strong> root.\nThe directory structure should be as follows: \/wp-content\/plugins\/forumpay-crypto-payments<\/strong>.<\/p>\n\n

After the module is installed, go back to the Plugins<\/strong> page and activate it.<\/p>\n\n

Configuration details:<\/h3>\n\n

General Settings<\/h4>\n\n
    \n

  1. Enable\/Disable<\/strong>\nCheck this box to enable the ForumPay Payment Module for your store.<\/p><\/li>\n

  2. Title<\/strong>\nThe label of the payment method that is displayed when user is prompted to choose one. You can leave default or set it to something like Pay with crypto<\/em>.<\/p><\/li>\n

  3. Description<\/strong>\nThe additional description of the payment method that is displayed under the title.<\/p><\/li>\n<\/ol>\n\n

    API Settings<\/h4>\n\n
      \n

    1. Environment<\/strong>\nDropdown lets you switch between 'Production' and 'Sandbox' modes.\nUse 'Production' for processing real transactions in a live environment and\n'Sandbox' for safe testing without financial implications.<\/p><\/li>\n

    2. API User<\/strong>\nThis is our identifier that we need to access the payment system.\nIt can be found in your Profile<\/strong>.\nGo to profile ><\/a><\/p><\/li>\n

    3. API Secret<\/strong>\nImportant:<\/em> never share it to anyone!\nThink of it as a password.\nAPI Secret consists of two parts. When generated in ForumPay dashboard<\/a>,\nthe first one will be displayed in your profile, while the second part will be sent to your e-mail.\nYou need to enter both parts here (one after the other).<\/p><\/li>\n

    4. POS ID<\/strong>\nThis is how payments coming to your wallets are going to be identified.\nSpecial characters are not allowed. Allowed characters are: A-Z<\/code>, a-z<\/code>, 0-9<\/code>, .<\/code>, _<\/code> and -<\/code> (e.g. my-shop<\/code>, my_shop<\/code>).<\/p><\/li>\n

    5. SID<\/strong>\nOptional: Enter unique identifier for a sub-account within your main account.<\/p><\/li>\n

    6. Webhook URL<\/strong>\nOptional: This URL should point to the endpoint that will handle webhook events.\nTypically: https:\/\/your-site.com\/wp-json\/wc-api\/wc_forumpay?act=webhook<\/code> or https:\/\/your-site.com\/?wc-api=wc_forumpay&act=webhook<\/code>\nIf set, this URL will override the default setting on your ForumPay Account.<\/p><\/li>\n

    7. Custom environment URL<\/strong>\nOptional: Override the URL to the API server regardless of the environment. Only used for debugging.<\/p><\/li>\n<\/ol>\n\n

      Payment Options<\/h4>\n\n
        \n

      1. Accept Instant (Zero) Confirmations<\/strong>\nAllows immediate transaction approval without waiting for network confirmations, enhancing speed but with increased risk. Please make sure you understand the risk before enabling this.<\/p><\/li>\n

      2. Auto-Accept Underpayments<\/strong>\nEnable this option to automatically accept payments that are less than the total order amount. Note that you will receive less funds if an underpayment is accepted.<\/p><\/li>\n

      3. Underpayment Threshold<\/strong>\nEnter the maximum percentage (0-100) of the order total that can be underpaid for the order to be accepted automatically.<\/p><\/li>\n

      4. Modify Order Total for Underpayments<\/strong>\nEnable to modify the order total to reflect underpayments as a separate fee. This will be negative to indicate less payment received.<\/p><\/li>\n

      5. Underpayment Fee Description<\/strong>\nDescription for the underpayment fee line item (e.g., \"ForumPay underpayment\").<\/p><\/li>\n

      6. Auto-Accept Overpayments<\/strong>\nEnable this option to automatically accept payments that are higher than the total order amount. Note that you will receive more funds if an overpayment is accepted. If you choose to not accept overpayments, any extra amounts will not be accepted and will be available for refunds (if possible).<\/p><\/li>\n

      7. Overpayment Threshold<\/strong>\nEnter the maximum percentage above the order total that will be accepted automatically if the order is overpaid.<\/p><\/li>\n

      8. Modify Order Total for Overpayments<\/strong>\nEnable to modify the order total to reflect overpayments as a separate fee. This will be positive to indicate extra payment received.<\/p><\/li>\n

      9. Overpayment Fee Description<\/strong>\nDescription for the overpayment fee line item (e.g., \"ForumPay overpayment\").<\/p><\/li>\n

      10. Auto-Accept Late Payments<\/strong>\nAutomatically accept the payment if transaction was received late and either the paid amount yields enough funds for the payment order or accepting it is allowed by the other Auto-Accept conditions.<\/p><\/li>\n<\/ol>\n\n

        System Information<\/h4>\n\n
          \n
        1. Installation ID<\/strong>\nUnique identifier for this installation (read-only, auto-generated).<\/li>\n<\/ol>\n\n

          Don't forget to click Save changes<\/em> button after the settings are filled in.<\/p>\n\n

          How to Test<\/h3>\n\n

          After configuring the plugin, follow this step-by-step guide to test the complete ForumPay payment flow in your WooCommerce store:<\/p>\n\n

          Step 1: Add Products to Cart<\/h4>\n\n
            \n
          1. Browse your store<\/strong> and select products you want to test<\/li>\n
          2. Add products to cart<\/strong> by clicking \"Add to Cart\" buttons<\/li>\n
          3. View cart<\/strong> to verify products are added correctly<\/li>\n
          4. Proceed to checkout<\/strong> when ready<\/li>\n<\/ol>\n\n

            Step 2: Checkout Process<\/h4>\n\n
              \n

            1. Fill in customer information:<\/strong><\/p>\n\n

                \n
              • Billing address<\/li>\n
              • Shipping address (if different)<\/li>\n
              • Contact information<\/li>\n<\/ul><\/li>\n

              • Select shipping method<\/strong> (if applicable)<\/p><\/li>\n

              • Choose payment method:<\/strong><\/p>\n\n

                  \n
                • Look for \"ForumPay\" or your custom payment title<\/li>\n
                • Select it as your payment method<\/li>\n
                • Verify that the correct description appears below<\/li>\n<\/ul><\/li>\n<\/ol>\n\n

                  Step 3: ForumPay Payment Widget<\/h4>\n\n
                    \n
                  1. Click \"Place Order\"<\/strong> button<\/li>\n
                  2. You'll be redirected<\/strong> to the ForumPay payment page<\/li>\n

                  3. Select cryptocurrency:<\/strong><\/p>\n\n

                      \n
                    • Choose from the dropdown (Bitcoin, Ethereum, etc.)<\/li>\n
                    • Verify that the exchange rate is displayed<\/li>\n
                    • Check that the fees and total amount are calculated correctly<\/li>\n<\/ul><\/li>\n

                    • Review payment details:<\/strong><\/p>\n\n

                        \n
                      • Order amount in your store currency<\/li>\n
                      • Cryptocurrency amount<\/li>\n
                      • Network fees<\/li>\n
                      • Total amount to pay<\/li>\n
                      • Expected confirmation time<\/li>\n<\/ul><\/li>\n<\/ol>\n\n

                        Step 4: Complete Payment<\/h4>\n\n
                          \n
                        1. Click \"START PAYMENT\"<\/strong> button<\/li>\n
                        2. QR Code appears<\/strong> with payment information<\/li>\n

                        3. Payment options:<\/strong><\/p>\n\n

                            \n
                          • Scan QR Code<\/strong> with your crypto wallet app<\/li>\n
                          • Copy address manually<\/strong> and send from your wallet<\/li>\n
                          • Use wallet integration<\/strong> if supported<\/li>\n<\/ul><\/li>\n

                          • Send payment<\/strong> from your cryptocurrency wallet<\/p><\/li>\n

                          • Wait for confirmations<\/strong> (time to wait depends on the selected cryptocurrency)<\/li>\n<\/ol>\n\n

                            Step 5: Payment Confirmation<\/h4>\n\n

                            Notice that:<\/p>\n\n

                              \n
                            1. Payment status updates automatically<\/li>\n
                            2. Order status changes in WooCommerce admin<\/li>\n
                            3. Confirmation email is sent to customer (if configured in WooCommerce)<\/li>\n
                            4. Order appears in WooCommerce orders list<\/li>\n<\/ol>\n\n

                              Testing in Sandbox Mode<\/h4>\n\n

                              For safe testing:\n1. Use Sandbox environment<\/strong> in plugin settings\n2. Test with small amounts<\/strong> first\n3. Monitor logs<\/strong> for any errors<\/p>\n\n\n

                              \n

                              Can not select cryptocurrency, there is no dropdown:<\/h3><\/dt>\n

                              This issue probably happens because webshop\\'s backend cannot access ForumPay.\nPlease check if your API keys in the configuration are correct.<\/p><\/dd>\n

                              The plugin has been installed and activated successfully, but it does not appear in the WooCommerce payments settings<\/h3><\/dt>\n

                              Please ensure that you have installed the latest release of the ForumPay Payment Gateway plugin.<\/p><\/dd>\n

                              Server returns **413 Request Entity Too Large** error when uploading the plugin zip file<\/h3><\/dt>\n

                              Please check your Nginx configuration. client_max_body_size<\/strong> and post_max_size<\/strong> properties should be larger than the uploaded .zip file<\/p>\n\n

                              server {\n    client_max_body_size 20M;\n    post_max_size 20M;\n\n    ...\n}\n<\/code><\/pre><\/dd>\n\n<\/dl>\n\n\n
                              2.1.3<\/h4>\n\n
                                \n
                              • Plugin released.<\/li>\n<\/ul>","raw_excerpt":"ForumPay Payment Gateway Module for Woocommerce","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/zh-hk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/187807","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/zh-hk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/zh-hk.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/zh-hk.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=187807"}],"author":[{"embeddable":true,"href":"https:\/\/zh-hk.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/forumpay"}],"wp:attachment":[{"href":"https:\/\/zh-hk.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=187807"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/zh-hk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=187807"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/zh-hk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=187807"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/zh-hk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=187807"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/zh-hk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=187807"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/zh-hk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=187807"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}