Keep control of funds
Customers pay to wallet addresses you control. Manatee watches the payment, but does not hold Bitcoin.
WooCommerce Bitcoin payment gateway
Accept Bitcoin in WooCommerce without giving up custody.
Add a non-custodial Bitcoin checkout flow to WooCommerce: customers pay directly to wallet addresses you control, while Manatee tracks payment status and signed events update your store.
Merchant benefits
Bitcoin checkout for stores that want direct wallet settlement.
Manatee helps WooCommerce merchants accept on-chain Bitcoin without routing customer funds through a hosted custodian or sharing private wallet keys.
No seed phrase sharing
Use server-side API keys and wallet receive data. Your private keys stay out of the integration.
Order-aware status updates
Map payment detection, confirmations, and expiry back to WooCommerce order state.
WooCommerce payment flow
From checkout selection to paid order.
The plugin flow should keep WooCommerce as the source of order state while Manatee provides payment verification and signed status events.
Customer chooses Bitcoin
The checkout offers Bitcoin as a payment method alongside your existing WooCommerce options.
Plugin creates payment
Your WordPress backend creates a Manatee payment for the WooCommerce order and stores the returned payment ID.
Checkout shows payment screen
The shopper sees the Bitcoin address, exact amount, expiry time, and payment instructions.
Manatee detects payment
Manatee watches the Bitcoin network and reports when a matching transaction appears.
Confirmations are tracked
The order remains in a waiting or confirming state until your configured confirmation threshold is reached.
WooCommerce order updates
Signed events let the plugin update the order status and keep a payment log for support and reconciliation.
Plugin screens
The WooCommerce areas this integration needs to cover.
Until final plugin screenshots are available, these placeholders describe the screens the payment gateway flow should expose to merchants and support teams.
Plugin settings
Configure testnet or mainnet API keys, webhook settings, confirmation policy, and checkout copy.
Checkout payment method
Show Bitcoin as a checkout option for customers who want to pay on-chain.
Bitcoin payment screen
Display the payment address, amount, expiry, and status while Manatee watches the transaction.
WooCommerce order details
Store the Manatee payment ID and surface payment state directly on the order.
Payment logs
Keep a concise timeline of detected transactions, confirmations, webhook updates, and expiry events.
Test mode
Validate the checkout with testnet before accepting real BTC.
Use a testnet API key to create payments, verify webhook handling, and confirm that WooCommerce order statuses change the way your store expects.
Order status mapping
Translate Bitcoin payment state into WooCommerce order state.
WooCommerce labels can be merchant-friendly, while the underlying payment signals come from Manatee status fields, received amounts, and webhook events.
pending
No matching Bitcoin transaction has been detected yet.
detected
A matching transaction was seen before the required confirmation threshold.
detected
The payment exists on-chain, but confirmations are still below your policy.
confirmed
The transaction reached the configured confirmation count.
received_sats below amount_sats
A payment amount is below the expected amount or outside the configured tolerance.
received_sats above amount_sats
The customer sent more than the expected amount. Your store decides how to handle the difference.
expired
The payment expired before a matching transaction was detected.
FAQ
Questions WooCommerce merchants usually ask first.
These answers keep the non-custodial model explicit and avoid treating Manatee as a wallet, exchange, or payment provider.
Does Manatee hold funds?
No. Customers send Bitcoin directly to wallet addresses you control. Manatee monitors payment state and sends signed events; it does not custody Bitcoin.
Do I need to share my wallet seed or private key?
No. Manatee does not need your seed phrase or private keys. Production setups should use wallet receive data such as a descriptor or extended public key, or a configured receiving address flow.
Can I test payments before going live?
Yes. Use a testnet API key to create payments, validate checkout copy, and verify order updates without moving real BTC.
How many confirmations are required?
You choose the confirmation threshold for each payment. Lower thresholds are faster; higher thresholds reduce settlement risk for higher-value orders.
What happens if a customer underpays?
Underpayment handling should follow your store policy. Manatee reports the expected and received satoshi amounts so the plugin can decide whether to wait, expire, or require manual review.
What happens if a customer overpays?
Manatee can surface that more Bitcoin was received than expected. Refunds or store-credit handling remain your business process because Manatee does not move funds.
Does this support Lightning?
Not during the public beta. Manatee currently focuses on on-chain Bitcoin payments with address monitoring, confirmations, and signed webhooks.
Implementation docs
Docs for payment status, webhooks, and secure setup.
These links cover the technical pieces behind a WooCommerce Bitcoin payment gateway.
Plugin beta
Prepare your WooCommerce store for non-custodial Bitcoin checkout.
Create a beta account, test payments on testnet, and get ready to connect the WooCommerce payment gateway when the plugin beta is available.