Skip to main content
Private betaMagento Open Source 2.4.8

Magento 2 Bitcoin payment extension

Bitcoin payments, fitted to the Magento order lifecycle.

Add an on-chain Bitcoin payment method without handing custody to a gateway. The extension keeps checkout, payment evidence, and order updates inside Magento while funds settle to wallet addresses you control.

Request required · Testnet4 first · Not marketplace-listed

Payment route

The extension coordinates state. It never takes possession of funds.

01 / StoreMagento checkout

Creates the order and requests exact Bitcoin payment instructions.

server request
02 / ModuleManatee extension

Stores the payment mapping, renders a local QR code, and verifies events.

signed events
03 / MonitorManatee API

Tracks pending, detected, and confirmed state for the assigned address.

direct payment
04 / SettlementYour wallet

Receives the customer's Bitcoin without a Manatee balance in between.

A Magento sends API credentials only from the server.

B Customers receive an exact address, amount, QR code, and expiry.

C Fulfilment follows verified payment state, not a frontend callback.

Operating boundary

A payment module with explicit responsibilities.

Private beta is the right stage to validate how the extension behaves inside your order, invoicing, and cancellation policies.Read the custody model
Inside MagentoStore responsibility
  • CheckoutPayment method and customer instructions
  • OrdersPayment metadata and status history
  • InvoicesCreated only after confirmed payment
  • OperationsFulfilment, support, and refund decisions
Outside custodyManatee responsibility
  • Payment requestAddress, amount, expiry, and reference
  • MonitoringTransaction detection and confirmations
  • EventsTimestamped, HMAC-signed webhook delivery
  • Never heldSeed phrases, private keys, or customer BTC

Private-beta process

Evaluate the integration against your store, not a generic demo.

Access is currently reviewed manually. That keeps compatibility feedback connected to a real Magento and PHP environment while the package is still pre-marketplace.

  1. 01

    Create a beta account

    Register with the email address you want us to use for the evaluation. The Magento interest is recorded with your request.

  2. 02

    Share your test environment

    Tell us your Magento and PHP versions and whether you are evaluating Testnet4 only or preparing for mainnet.

  3. 03

    Run one complete order

    Validate payment creation, detection, confirmation, cancellation, and webhook retries before considering a live rollout.

Suggested acceptance run
  1. Place order
  2. Detect payment
  3. Confirm invoice
  4. Review cancellation
  5. Verify retry handling

Before requesting access

What the private-beta label means.

The module is functional, but distribution and compatibility feedback are still handled directly. There is no public Magento Marketplace download yet.

Is the extension available in the Adobe Commerce Marketplace?

Not yet. The current Magento Open Source extension is distributed directly to approved private-beta participants. This page does not claim a public marketplace release.

Does the extension store private wallet keys?

No. It uses a network-scoped Manatee API key and the matching webhook secret. Seed phrases and private keys stay outside Magento and Manatee.

When does Magento create an invoice?

The extension creates the Magento invoice only after it has processed a valid signed payment.confirmed event. A browser redirect alone does not mark the order paid.

Can a cancelled order still receive a Bitcoin payment?

A payment already detected on the Bitcoin network continues to confirmation. The extension keeps the payment state and shows a manual-review notice instead of treating the funds as cancelled.

Private betaMagento 2

Ready to test on Magento Open Source 2.4.8?

Request the package and start with Testnet4.

Create beta accountAlready registered? Email [email protected]Never send API keys, webhook secrets, descriptors, seed phrases, or private keys by email.