{"id":390302,"date":"2026-10-24T11:04:51","date_gmt":"2026-10-24T11:04:51","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/bb84-payments-for-woocommerce\/"},"modified":"2026-10-24T11:04:35","modified_gmt":"2026-10-24T11:04:35","slug":"bb84-payments-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/bb84-payments-for-woocommerce\/","author":23589982,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.3","stable_tag":"1.0.3","tested":"7.1.3","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"bb84 Payments for WooCommerce","header_author":"Hadamard Corporation","header_description":"Accept USDC and EURC payments with the bb84 app. Non-custodial: customers pay straight to your bb84 name, orders are marked paid automatically once the payment arrives on-chain.","assets_banners_color":"111925","last_updated":"2026-10-24 11:04:35","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/bb84.com","header_author_uri":"https:\/\/hadamard.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":67,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.3":{"tag":"1.0.3","author":"bb84","date":"2026-10-24 11:04:35","revision":3763165}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3763164,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3763164,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3763172,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3763172,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.3"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3763164,"resolution":"1","location":"assets","locale":"","width":592,"height":939},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3763164,"resolution":"2","location":"assets","locale":"","width":1100,"height":878},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3763164,"resolution":"3","location":"assets","locale":"","width":1280,"height":1000}},"screenshots":{"1":"\"Pay with bb84\" in the block checkout.","2":"Thank-you page: amount, recipient, purpose and the pay button. It switches to \"Payment received\" by itself.","3":"Settings: your bb84 name, texts and the payment window."}},"plugin_section":[],"plugin_tags":[288242,1887,231844,209195,286],"plugin_category":[45],"plugin_contributors":[288243],"plugin_business_model":[],"class_list":["post-390302","plugin","type-plugin","status-publish","hentry","plugin_tags-eurc","plugin_tags-payments","plugin_tags-stablecoin","plugin_tags-usdc","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-bb84","plugin_committers-bb84"],"banners":{"banner":"https:\/\/ps.w.org\/bb84-payments-for-woocommerce\/assets\/banner-772x250.png?rev=3763172","banner_2x":"https:\/\/ps.w.org\/bb84-payments-for-woocommerce\/assets\/banner-1544x500.png?rev=3763172","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/bb84-payments-for-woocommerce\/assets\/icon-128x128.png?rev=3763164","icon_2x":"https:\/\/ps.w.org\/bb84-payments-for-woocommerce\/assets\/icon-256x256.png?rev=3763164","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/bb84-payments-for-woocommerce\/assets\/screenshot-1.png?rev=3763164","caption":"\"Pay with bb84\" in the block checkout."},{"src":"https:\/\/ps.w.org\/bb84-payments-for-woocommerce\/assets\/screenshot-2.png?rev=3763164","caption":"Thank-you page: amount, recipient, purpose and the pay button. It switches to \"Payment received\" by itself."},{"src":"https:\/\/ps.w.org\/bb84-payments-for-woocommerce\/assets\/screenshot-3.png?rev=3763164","caption":"Settings: your bb84 name, texts and the payment window."}],"raw_content":"<!--section=description-->\n<p>Customers choose \"Pay with bb84\" at checkout, open the bb84 app from the thank-you page (or the order email)\nand confirm the payment. The money goes straight to your bb84 name; the plugin never holds funds or keys.<\/p>\n\n<ul>\n<li>EUR orders are paid in EURC, USD orders in USDC (1:1). Other store currencies hide the method.<\/li>\n<li>Every order gets a unique purpose (e.g. <code>Order-1042-K7QX<\/code>). It travels on-chain with the payment, so the\nplugin can match it to the order and mark the order paid with the transaction hash.<\/li>\n<li>Every payment is a merchant payment: the bb84 app sends it as \"Goods &amp; Services\", with buyer protection\nfor the customer and the bb84 platform fee deducted from the amount you receive.<\/li>\n<li>Works with the classic and the block checkout, and with HPOS.<\/li>\n<li>No API key, no account with us: the plugin only reads the public pages of your name on <code>&lt;name&gt;.bb84.com<\/code>.<\/li>\n<li>Optional \"Pay with BB84\" badge (off by default): enable it for the site footer in the settings or place it with\nthe <code>[bb84_badge]<\/code> shortcode (<code>[bb84_badge style=\"light\"]<\/code> for the light variant). The images ship with the plugin.<\/li>\n<\/ul>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to bb84.com, the public web service of the bb84 network operated by Hadamard Corporation\n(the provider of this plugin). It is required for the plugin to work: payments are made in the bb84 app and can only be\nseen on the bb84 network, so the plugin asks bb84.com whether an order has been paid. Every shop uses the pages of its own\nbb84 name, <code>https:\/\/&lt;name&gt;.bb84.com<\/code>.<\/p>\n\n<p>What is sent, and when:<\/p>\n\n<ul>\n<li><code>https:\/\/&lt;name&gt;.bb84.com\/<\/code> \u2013 once, when you save your bb84 name in the settings, to check that the name is registered.\nSent: your bb84 name (as part of the address).<\/li>\n<li><code>https:\/\/&lt;name&gt;.bb84.com\/api\/paid<\/code> \u2013 for every open bb84 order, by WP-Cron every two minutes and every few seconds\nwhile the customer waits on the thank-you page, until the order is paid or cancelled. Sent: your bb84 name, the order\namount, the currency (EURC or USDC) and the order's payment purpose (e.g. <code>Order-1042-K7QX<\/code>). No customer name, email,\naddress or IP address is sent; the request comes from your server.<\/li>\n<li><code>https:\/\/&lt;name&gt;.bb84.com\/&lt;amount&gt;\/&lt;currency&gt;\/&lt;purpose&gt;?gs=1<\/code> \u2013 the hosted payment page. It is only opened by the\ncustomer's browser when the customer clicks \"Pay now with bb84\" on the thank-you page or in the order email. Like any\nweb page it receives the customer's IP address and browser details.<\/li>\n<\/ul>\n\n<p>The payment purpose is written on-chain together with the payment and is publicly visible, like every bb84 transaction.<\/p>\n\n<ul>\n<li>Terms of service: https:\/\/bb84.com\/terms<\/li>\n<li>Privacy policy: https:\/\/bb84.com\/privacy<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the ZIP under Plugins \u2192 Add New \u2192 Upload Plugin and activate it.<\/li>\n<li>WooCommerce \u2192 Settings \u2192 Payments \u2192 bb84: enter your bb84 name (e.g. <code>myshop.bb84.eth<\/code>) and enable it.\nUse a merchant (Goods &amp; Services) account so customers get buyer protection.<\/li>\n<li>Set the store currency to EUR or USD.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"how%20is%20a%20payment%20confirmed%3F\"><h3>How is a payment confirmed?<\/h3><\/dt>\n<dd><p>WP-Cron checks open bb84 orders every two minutes, and the thank-you page checks every few seconds while the\ncustomer waits. A payment only completes an order when its on-chain purpose matches. A payment of the right\namount without any purpose is added as an order note for you to check by hand.<\/p><\/dd>\n<dt id=\"what%20about%20the%20goods%20%26%20services%20fee%3F\"><h3>What about the Goods &amp; Services fee?<\/h3><\/dt>\n<dd><p>G&amp;S payments lose the protocol fee (currently 0.5 %) on the way; payments of at least 99 % of the order total count as paid.<\/p><\/dd>\n<dt id=\"what%20happens%20to%20unpaid%20orders%3F\"><h3>What happens to unpaid orders?<\/h3><\/dt>\n<dd><p>They stay \"on hold\" (stock reserved) for the payment window (default 12 hours, at most 23) and are then cancelled.\nA payment that still arrives within 24 hours of the order reopens it and marks it paid.<\/p><\/dd>\n<dt id=\"my%20shop%20has%20little%20traffic.\"><h3>My shop has little traffic.<\/h3><\/dt>\n<dd><p>WP-Cron only runs on page views. Add a real cron job that calls <code>wp-cron.php<\/code> every few minutes, or run\n    wp cron event run bb84_payments_check.<\/p><\/dd>\n<dt id=\"refunds%3F\"><h3>Refunds?<\/h3><\/dt>\n<dd><p>bb84 is non-custodial, so refunds are sent from your bb84 app. Mark the order refunded in WooCommerce by hand.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Optional \"Pay with BB84\" badge for the site footer (off by default) and <code>[bb84_badge]<\/code> shortcode.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Text domain is now bb84-payments-for-woocommerce (translations come from translate.wordpress.org).<\/li>\n<li>Readme: external services described in more detail.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Payments are marked as shop payments: the bb84 app always sends them as \"Goods &amp; Services\" (buyer protection).<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"Accept USDC and EURC with the bb84 app. Non-custodial, orders are completed automatically.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/390302","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=390302"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/bb84"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=390302"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=390302"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=390302"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=390302"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=390302"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=390302"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}