Manatee Documentation
Use these docs to test Manatee without direct support. Start with a testnet API key, create a payment, receive signed webhook events, and move to mainnet only after your checkout flow is verified.
These pages document the public v1 API. Each guide shows its last update time; use the generated API Reference when you need the exact schema deployed today. Current WooCommerce release details and compatibility are maintained on WordPress.org.
Start here
| Goal | Read this |
|---|---|
| Create your first test payment | Quickstart |
| Understand API keys and endpoints | API and authentication |
| Look up exact OpenAPI schemas | API Reference |
| Test before going live | Testing and live mode |
| Process webhook events safely | Webhooks |
| Verify signatures and prevent replay | Security |
| Handle payment edge cases | Reconciliation and edge cases |
| Understand supported assets and custody boundaries | Supported assets |
| Review beta pricing and technical limits | Beta pricing and limits |
| Prepare a WooCommerce store | WooCommerce setup · Install plugin |
| Prepare a Shopware 6 store | Shopware 6 private-beta setup |
| Evaluate a Magento 2 store | Magento 2 private-beta overview |
Developer path
- Create a beta account and get a testnet API key.
- Read API and authentication.
- Follow the Quickstart to create a test payment.
- Send a test webhook to your endpoint.
- Verify webhook signatures using the Security guide.
- Implement the payment lifecycle, then define reconciliation rules.
- Use the generated API Reference for exact request fields, response schemas, and error codes.
Store owner path
If you are evaluating Manatee for an online store, start with the integration overview:
- WooCommerce setup
- Official Manatee WooCommerce plugin on WordPress.org
- Shopware 6 private-beta setup
- Magento 2 private-beta overview
- Testnet vs mainnet
- Frequently asked questions
Manatee is non-custodial. Customer payments go directly to wallet addresses you control. Manatee monitors payment status and sends signed events; it does not hold funds, provide a wallet, custody fiat balances, exchange funds, or send refunds.
Troubleshooting
| Problem | Where to look |
|---|---|
| Invalid API key | API and authentication |
| Webhook failed | Webhooks |
| Payment expired | Status model |
| Underpayment | Status model |
| Overpayment | Status model |
| Missing confirmations | Status model |
| Plan limit exceeded | FAQ |
| Plugin cannot connect | WooCommerce setup |
OpenAPI reference
The generated OpenAPI documentation remains available at API Reference. Use it whenever you need exact endpoint paths, request and response fields, enum values, error responses, or schema details.