Manatee Bitcoin and Bitcoin Cash Gateway for WooCommerce

Descripción

Manatee adds one “Pay with crypto” method to WooCommerce checkout. Within it, customers can choose Bitcoin (BTC) or Bitcoin Cash (BCH). The plugin creates an asset-scoped payment, shows the returned address, amount, wallet URI, and local QR code, then updates the order from signed webhook events.

Manatee is non-custodial. The plugin does not hold customer funds, request wallet seeds or private keys, or run blockchain node logic inside WordPress. Bitcoin and Bitcoin Cash are available for testnet and mainnet payments; each asset requires a receive wallet configured for the selected API key network.

The plugin is built for merchants and developers who want to accept supported on-chain crypto payments while keeping checkout, order metadata, and webhook handling inside WordPress.

Features

• One WooCommerce crypto payment method with a clear BTC/BCH selector.
• Non-custodial flow: no wallet seed, private key, or hosted wallet custody is required by the plugin.
• Test and live environment mode setting.
• Shared network API key and webhook secret with separate BTC and BCH confirmation settings.
• Cached plan allowance and active webhook monitor overview at the top of settings.
• Read-only API connection and usage refresh from the gateway settings screen.
• Asset-specific customer payment screen with address, satoshi amount, wallet URI, local QR code, expiry, and automatic status polling.
• Classic checkout and WooCommerce Checkout Blocks support.
• Signed webhook verification with timestamp and event ID handling.
• Automatic WooCommerce order updates after Manatee payment events.
• Pending Manatee payments are cancelled when the WooCommerce order is cancelled.
• Order metadata for asset, network, payment ID, address, satoshi amount, pricing data, environment, transaction ID, confirmations, status, and expiry.
• WooCommerce logging with secret redaction.
• WooCommerce HPOS compatibility.

How it works

1. A customer selects “Pay with crypto” and chooses BTC or BCH.
2. The plugin sends the WooCommerce order total to Manatee as fiat_amount and fiat_currency.
3. The plugin calls the matching /v1/btc/payments or /v1/bch/payments route.
4. The customer sees asset-specific payment instructions on the order received page.
5. Manatee monitors the payment lifecycle and sends signed webhook events to the shop.
6. The plugin verifies signature, timestamp, event ID, payment ID, asset, network, and order mapping before mutation.
7. WooCommerce order status and Manatee payment metadata are updated automatically.
8. If a pending WooCommerce order is cancelled, the plugin asks Manatee to cancel the pending payment. Payments already detected on-chain are left for manual review.
9. The order received page polls the shop for verified status updates using the WooCommerce order key.

Setup

Before accepting payments, configure the gateway in WooCommerce > Settings > Payments > Crypto via Manatee:

• Environment Mode: choose Test or Live.
• API Base URL: use https://api.manatee-api.io unless Manatee support tells you otherwise.
• API Key: enter the Manatee API key for the selected environment.
• Bitcoin / Bitcoin Cash: choose which configured assets customers may use.
• Webhook Secret: enter the secret used to verify Manatee webhook signatures.
• Webhook URL Override: leave empty unless Manatee cannot reach the automatically generated WordPress REST endpoint.
• BTC / BCH Confirmations Required: configure the confirmation target for each asset.
• Payment Expiry Minutes: define how long new payment requests remain payable.
• Order Status When Detected: choose the status used when a transaction is seen but not fully confirmed.
• Order Status When Confirmed: choose the fallback status used after confirmation if WooCommerce cannot complete the payment automatically.

The settings header shows remaining monthly confirmed mainnet payments and active webhook monitors by network. “Save, refresh and test connection” persists changed settings before sending a read-only GET /v1/usage request.
The API Key and Webhook Secret fields include reveal controls so an authorized WooCommerce administrator can verify the entered values before saving.

Test mode

Use Test mode with a testnet Manatee API key before going live. Enable BTC or BCH only after configuring the corresponding receive wallet for that network in Manatee.

When switching to Live mode, use a mainnet Manatee API key, review the webhook secret, confirm that the webhook URL is reachable from the public internet, and test a low-value payment before opening the payment method to customers.

Privacy / Data Sent to Manatee API

When a customer selects BTC or BCH, the plugin sends the WooCommerce fiat amount, currency, webhook URL, required confirmation count, expiry window, underpayment tolerance, and order reference to the corresponding Manatee API route.

The WooCommerce order stores asset, network, Manatee payment ID, payment address, satoshi amount, pricing metadata, environment mode, status, transaction ID, confirmations, and expiry.

Webhook events are verified with the X-Manatee-Signature, X-Manatee-Timestamp, and X-Manatee-Event-Id headers before order mutation.

External services

This plugin connects to the Manatee Payment API to create and verify non-custodial BTC and BCH payments for WooCommerce orders.

When a customer chooses an asset, the plugin sends the order amount, currency, webhook URL, required confirmations, expiry, tolerance, and reference to the asset-specific API route. The API returns asset, network, payment ID, address, satoshi amount, exchange-rate metadata, expiry, and status.

The settings screen sends a briefly cached read-only usage request, and the merchant can refresh it with the connection-test action. When a pending order is cancelled, the plugin may send an asset-scoped cancellation request. Manatee sends signed webhook events back to update the order after detection or confirmation.

This service is provided by Manatee.

Privacy Policy: https://manatee-api.io/privacy-policy