Manatee Bitcoin Payment Verification API

Manatee helps developers create and verify non-custodial Bitcoin payment flows. Create a payment, show the customer a Bitcoin address and amount, track transaction detection and confirmations, and receive signed webhook events when the payment state changes.

原始信息汇总

Manatee Bitcoin Payment Verification API 数据集详情

基本信息

• API 名称: Manatee Bitcoin Payment Verification API
• 提供方: Chris H.
• 分类: Payments（支付）
• 价格: 免费
• 服务等级: 100%
• 延迟: 49ms
• 当前版本: 0.3.0

功能概述

Manatee 是一个非托管的比特币支付验证 API，专为开发自定义结账系统、SaaS 计费流程、WooCommerce 商店、Shopware 集成和后端订单自动化而设计。该 API 不持有客户资金，不要求钱包种子短语或私钥，也不作为受监管的支付托管方。开发者通过 API 创建支付请求，Manatee 监控比特币网络以匹配交易、跟踪确认次数，并在支付状态变更时向后端发送签名的 Webhook 事件。

典型集成流程

1. 通过 API 创建比特币支付。
2. 向客户显示返回的比特币地址和固定的聪（satoshi）金额。
3. 检测传入交易。
4. 跟踪确认次数，直到达到配置的阈值。
5. 接收签名的 Webhook 事件。
6. 更新后端的订单、发票或订阅状态。

使用环境

• 沙箱/测试网使用：此 RapidAPI 列表专为沙箱和开发者探索而设计。测试时需在 Manatee 仪表盘中创建沙箱/测试网 API 密钥，并以 Bearer token 形式使用（如 Authorization: Bearer YOUR_MANATEE_TESTNET_API_KEY）。
• 生产环境：应通过 Manatee 仪表盘配置自有账户、API 密钥、Webhook 设置和钱包接收配置。

基础 URL

https://api.manatee-api.io

主要端点

• POST /v1/btc/payments：创建比特币支付。
• GET /v1/btc/payments/{id}：获取指定支付详情。
• GET /v1/btc/payments：获取支付列表。
• POST /v1/btc/payments/{id}/cancel：取消指定支付。
• GET /v1/btc/payments/{id}/webhook-events：获取指定支付的 Webhook 事件。
• POST /v1/webhooks/test：测试 Webhook 端点的可达性、载荷解析和签名验证。

创建支付请求示例

• 请求方式: POST / https://api.manatee-api.io/v1/btc/payments

• 请求头: Content-Type: application/json，Authorization: Bearer YOUR_MANATEE_TESTNET_API_KEY

• 请求体示例: json { "fiat_amount": "49.00", "fiat_currency": "EUR", "webhook_url": "https://example.com/webhooks/manatee", "required_confirmations": 3, "expires_in": 3600, "reference": "order-123" }

• 响应示例: json { "id": "pay_123", "address": "tb1qexampleaddress", "amount_sats": 85000, "fiat_amount": "49.00", "fiat_currency": "EUR", "exchange_rate": "57647.05", "pricing_source": "coinbase", "received_sats": 0, "status": "pending", "confirmations": 0, "required_confirmations": 3, "network": "testnet", "reference": "order-123" }

支付状态说明

• pending: 支付已创建，等待传入交易。
• detected: 检测到匹配交易，等待确认。
• confirmed: 已达到所需的确认阈值。
• expired: 在过期前未检测到交易。
• cancelled: 在检测前，待处理的支付已被取消。

Webhook 机制

Manatee 在支付状态变更时发送签名的 Webhook 事件，请求中包含以下 HMAC 头部信息：

• X-Manatee-Signature
• X-Manatee-Timestamp
• X-Manatee-Event-Id

可通过 POST /v1/webhooks/test 端点在不创建比特币交易的情况下测试 Webhook。