{"id":403444,"date":"2026-11-12T06:47:51","date_gmt":"2026-11-12T06:47:51","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/miraclepay-for-woocommerce\/"},"modified":"2026-11-12T06:47:21","modified_gmt":"2026-11-12T06:47:21","slug":"miraclepay-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/miraclepay-for-woocommerce\/","author":23604102,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1.4","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"MiraclePay for WooCommerce","header_author":"MiraclePay","header_description":"Accept crypto payments with MiraclePay's hosted checkout. Creates a signed payment prompt through the MiraclePay External API and keeps orders in sync via signed webhooks.","last_updated":"2026-11-12 06:47:21","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/miraclepay.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":42,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"kubilayarkan","date":"2026-11-12 06:47:21","revision":3797623}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3797628,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3797628,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3797628,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3797628,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[1886,21057,6593,209195,286],"plugin_category":[45],"plugin_contributors":[292163],"plugin_business_model":[],"class_list":["post-403444","plugin","type-plugin","status-publish","hentry","plugin_tags-bitcoin","plugin_tags-crypto","plugin_tags-payment-gateway","plugin_tags-usdc","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-kubilayarkan","plugin_committers-kubilayarkan"],"banners":{"banner":"https:\/\/ps.w.org\/miraclepay-for-woocommerce\/assets\/banner-772x250.png?rev=3797628","banner_2x":"https:\/\/ps.w.org\/miraclepay-for-woocommerce\/assets\/banner-1544x500.png?rev=3797628","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/miraclepay-for-woocommerce\/assets\/icon-128x128.png?rev=3797628","icon_2x":"https:\/\/ps.w.org\/miraclepay-for-woocommerce\/assets\/icon-256x256.png?rev=3797628","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Adds MiraclePay as a WooCommerce payment method. The customer places the order\non your store, pays in crypto on MiraclePay's hosted checkout, and the order is\nsettled automatically by a signed webhook.<\/p>\n\n<ul>\n<li>Signed (HMAC-SHA512) requests against the MiraclePay External API<\/li>\n<li>Signed webhooks keep orders in sync even when the customer never returns<\/li>\n<li>Supports both the classic checkout and the Cart\/Checkout Blocks<\/li>\n<li>HPOS (high-performance order storage) compatible<\/li>\n<li>Idempotent order creation and duplicate-safe webhook processing<\/li>\n<\/ul>\n\n<p>Stores must be in USD: the MiraclePay API settles in USD and this plugin does\nnot convert currencies.<\/p>\n\n<h3>External services<\/h3>\n\n<p>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.<\/p>\n\n<ul>\n<li><strong>Creating a payment<\/strong> (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.<\/li>\n<li><strong>Checking a payment<\/strong> (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.<\/li>\n<li><strong>Listing networks<\/strong> (only on the plugin's settings screen, cached for one hour): the plugin requests the list of active blockchain networks.<\/li>\n<\/ul>\n\n<p>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.<\/p>\n\n<p>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 (<code>?wc-api=miraclepay<\/code>) to report the payment status.<\/p>\n\n<ul>\n<li>MiraclePay Terms of Use: https:\/\/merchant.miraclepay.com\/documents\/terms-of-use.html<\/li>\n<li>MiraclePay Privacy Policy: https:\/\/www.miraclepay.com\/privacy-policy<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin and activate it.<\/li>\n<li>Go to WooCommerce &gt; Settings &gt; Payments &gt; MiraclePay.<\/li>\n<li>Enter the API key id, signing secret and passphrase from your MiraclePay\ndashboard, and select the matching environment.<\/li>\n<li>Add your store domain to the allowed redirect domains in the dashboard.<\/li>\n<li>Add https:\/\/your-store.example\/?wc-api=miraclepay as a webhook endpoint\nsubscribed to the payment.* events, and paste its signing secret into the\ngateway settings.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"can%20i%20refund%20through%20woocommerce%3F\"><h3>Can I refund through WooCommerce?<\/h3><\/dt>\n<dd><p>No. The External API has no refund endpoint, so refunds are issued from the\nMiraclePay dashboard.<\/p><\/dd>\n<dt id=\"why%20is%20the%20payment%20method%20missing%20at%20checkout%3F\"><h3>Why is the payment method missing at checkout?<\/h3><\/dt>\n<dd><p>The gateway hides itself when the store currency is not USD or when the API\ncredentials are incomplete. The settings screen lists whichever applies.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Accept crypto payments in WooCommerce through MiraclePay's hosted checkout.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/403444","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=403444"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kubilayarkan"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=403444"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=403444"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=403444"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=403444"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=403444"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=403444"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}