Skip to main content

Bitcoin payment infrastructure for developers

Bitcoin payments that settle directly to your wallet.

Create payment requests, track confirmations, and update orders through signed webhooks. Manatee monitors payment status but never holds customer funds.

Try checkout demoRead the QuickstartBeta pricing

Free beta access · Testnet4 ready · No custody

Explore
Non-custodialBitcoin goes to your wallet
Server-sideREST API and signed webhooks
TestableDedicated Testnet4 credentials
European-operatedCore infrastructure in Europe

API responsibilities

What Manatee handles for your checkout.

Keep your product focused on orders and customers while Manatee handles blockchain observation, confirmations, and reliable status delivery.

A small, predictable API

Create a payment with satoshis or a fiat amount, your order reference, expiry, and confirmation policy.

API basics

Your wallet, your funds

Payments settle directly to addresses you control. Manatee monitors state without holding or moving Bitcoin.

Wallet setup

Signed status events

Verify HMAC-signed webhooks before changing an order and reject stale or forged delivery attempts.

Verify webhooks

A clear payment lifecycle

Handle pending, detected, confirmed, expired, and cancelled states without inventing blockchain semantics.

Status model

Safe retries by default

Use idempotency keys for payment creation and event IDs for webhook processing so retries stay harmless.

Idempotency

Testnet4 before mainnet

Keep test and live credentials separate and validate the complete checkout flow before accepting real BTC.

Testing networks

Checkout lifecycle

Create, present, and reconcile each payment.

Your order system keeps the customer and fulfillment state; Manatee reports the Bitcoin payment state.

01

Create

Your backend creates one payment for one order and stores the returned payment ID.

02

Present

Show the exact Bitcoin amount, receiving address, QR code, and expiry in your checkout.

03

Reconcile

Verify signed events and update the order when the configured confirmation threshold is reached.

Your backend stays in control

Trust the event only after you verify it.

Each delivery includes a timestamp, event ID, and HMAC signature. Verify the raw body, reject stale timestamps, and process every event idempotently.

Read the verification guide
payment.confirmed verified
{
  "version": "1",
  "type": "payment.confirmed",
  "data": {
    "payment_id": "pay_abc123",
    "txid": "a1b2c3d4…",
    "address": "tb1q…7px4",
    "amount_sats": 84730,
    "received_sats": 84730,
    "confirmations": 3,
    "webhook_url": "https://shop.example/webhooks/btc"
  }
}

Choose your starting point

Build directly or install the gateway.

Use the same non-custodial payment lifecycle from your own backend or connect an existing commerce platform.

REST API

For custom products and checkout flows

Use a compact JSON API, generated OpenAPI reference, signed webhooks, and language-neutral examples.

WooCommerce

For WordPress stores

Install the official gateway, configure Test or Live mode, and keep payment state next to the WooCommerce order.

Private beta / Magento Open Source 2.4.8Evaluate the Magento 2 Bitcoin payment extension

Built and operated from Europe

Core infrastructure in Europe. Funds in your wallet.

Manatee combines European-operated application infrastructure with Cloudflare's global public security edge. It never needs your seed phrase or private keys.

Hosting details

Start on Testnet4

Your first payment request is one API call away.

Follow the Quickstart, connect a webhook, and verify payment creation, confirmation, and fulfillment before moving to mainnet.