Title: MiraclePay for WooCommerce Author: kubilayarkan Published: November 12, 2026 Last modified: November 12, 2026 --- Search plugins ![](https://ps.w.org/miraclepay-for-woocommerce/assets/banner-772x250.png?rev=3797628) ![](https://ps.w.org/miraclepay-for-woocommerce/assets/icon-256x256.png?rev=3797628) # MiraclePay for WooCommerce By [kubilayarkan](https://profiles.wordpress.org/kubilayarkan/) [Download](https://downloads.wordpress.org/plugin/miraclepay-for-woocommerce.1.0.0.zip) * [Details](https://wordpress.org/plugins/miraclepay-for-woocommerce/#description) * [Reviews](https://wordpress.org/plugins/miraclepay-for-woocommerce/#reviews) * [Installation](https://wordpress.org/plugins/miraclepay-for-woocommerce/#installation) * [Development](https://wordpress.org/plugins/miraclepay-for-woocommerce/#developers) [Support](https://wordpress.org/support/plugin/miraclepay-for-woocommerce/) ## Description Adds MiraclePay as a WooCommerce payment method. The customer places the order on your store, pays in crypto on MiraclePay’s hosted checkout, and the order is settled automatically by a signed webhook. * Signed (HMAC-SHA512) requests against the MiraclePay External API * Signed webhooks keep orders in sync even when the customer never returns * Supports both the classic checkout and the Cart/Checkout Blocks * HPOS (high-performance order storage) compatible * Idempotent order creation and duplicate-safe webhook processing Stores must be in USD: the MiraclePay API settles in USD and this plugin does not convert currencies. ### External services This plugin connects to the MiraclePay API, a third-party payment service operated by MiraclePay, to create and check crypto payments. It cannot work without it. Nothing is sent until the gateway is enabled and configured with your MiraclePay API credentials. * **Creating a payment** (when a customer places an order with MiraclePay): the plugin sends the order total in USD cents, an order reference (the WooCommerce order ID), the URL of the order-received page to return the customer to, a short note containing the order number and store name, and, if you restricted them, the accepted blockchain networks. * **Checking a payment** (when the customer returns to the order-received page, or pays again for an existing order): the plugin sends the MiraclePay payment ID to read its current status. * **Listing networks** (only on the plugin’s settings screen, cached for one hour): the plugin requests the list of active blockchain networks. Every request carries your API key ID, passphrase and an HMAC signature, plus your store’s home URL in the User-Agent header. Requests go to https://be.miraclepay. com (Production), https://api.miraclecash.info (Development / sandbox), or the custom API URL you enter. After placing the order, the customer is redirected to MiraclePay’s hosted checkout, where they choose a network and pay. Their wallet and payment details are entered on MiraclePay, not on your store. MiraclePay then sends signed webhooks back to your store (`?wc-api=miraclepay`) to report the payment status. * MiraclePay Terms of Use: https://merchant.miraclepay.com/documents/terms-of-use. html * MiraclePay Privacy Policy: https://www.miraclepay.com/privacy-policy ## Installation 1. Upload the plugin and activate it. 2. Go to WooCommerce > Settings > Payments > MiraclePay. 3. Enter the API key id, signing secret and passphrase from your MiraclePay dashboard, and select the matching environment. 4. Add your store domain to the allowed redirect domains in the dashboard. 5. Add https://your-store.example/?wc-api=miraclepay as a webhook endpoint subscribed to the payment.* events, and paste its signing secret into the gateway settings. ## FAQ ### Can I refund through WooCommerce? No. The External API has no refund endpoint, so refunds are issued from the MiraclePay dashboard. ### Why is the payment method missing at checkout? The gateway hides itself when the store currency is not USD or when the API credentials are incomplete. The settings screen lists whichever applies. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “MiraclePay for WooCommerce” is open source software. The following people have contributed to this plugin. Contributors * [ kubilayarkan ](https://profiles.wordpress.org/kubilayarkan/) [Translate “MiraclePay for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/miraclepay-for-woocommerce) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/miraclepay-for-woocommerce/), check out the [SVN repository](https://plugins.svn.wordpress.org/miraclepay-for-woocommerce/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/miraclepay-for-woocommerce/) by [RSS](https://plugins.trac.wordpress.org/log/miraclepay-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.0 * Initial release. ## Meta * Version **1.0.0** * Last updated **6 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **7.1.4** * PHP version ** 7.4 or higher ** * Tags * [bitcoin](https://wordpress.org/plugins/tags/bitcoin/)[crypto](https://wordpress.org/plugins/tags/crypto/) [payment gateway](https://wordpress.org/plugins/tags/payment-gateway/)[usdc](https://wordpress.org/plugins/tags/usdc/) [woocommerce](https://wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://wordpress.org/plugins/miraclepay-for-woocommerce/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/miraclepay-for-woocommerce/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/miraclepay-for-woocommerce/reviews/) ## Contributors * [ kubilayarkan ](https://profiles.wordpress.org/kubilayarkan/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/miraclepay-for-woocommerce/)