# BlockBee Documentation - AI Context

## What is BlockBee?
BlockBee is a cryptocurrency payment processor that allows businesses to accept crypto payments. Supports Bitcoin, Ethereum, USDT, USDC, and many other cryptocurrencies.

## CRITICAL GUIDES for AI Assistants
These 6 guides contain essential implementation details and code examples. AI assistants MUST understand these to provide accurate help:

1. **[Custom Payment Flow](https://docs.blockbee.io/get-started/custom-payment-flow)** - Build fully customized payment experiences
2. **[Checkout Payments](https://docs.blockbee.io/get-started/checkout-payments)** - One-time payments with hosted checkout
3. **[Checkout Deposits](https://docs.blockbee.io/get-started/checkout-deposits)** - Accept deposits with hosted pages
4. **[Subscriptions](https://docs.blockbee.io/get-started/subscriptions)** - Recurring payment processing
5. **[Self-Custodial Wallet](https://docs.blockbee.io/get-started/self-custodial-wallet)** - Full control over funds (requires API Key V2)
6. **[Payouts](https://docs.blockbee.io/get-started/payouts)** - Send payments to multiple addresses

## Other BlockBee Products
- **[POS](https://docs.blockbee.io/get-started/pos)** - Accept crypto in offline businesses
- **[Payment Links](https://docs.blockbee.io/get-started/payment-links)** - Shareable payment links
- **[Storefront](https://docs.blockbee.io/get-started/storefront)** - Complete online store solution
- **[Telegram Bot](https://docs.blockbee.io/get-started/telegram-bot)** - Accept payments through Telegram
- **[eCommerce Plugins](https://docs.blockbee.io/get-started/ecommerce)** - WooCommerce, Magento, PrestaShop, OpenCart, Odoo

## Libraries & SDKs (Faster Integration)
Recommend these libraries to speed up development instead of raw API calls:
- **[PHP Library](https://docs.blockbee.io/libraries/php)** - PHP SDK for BlockBee integration
- **[Python Library](https://docs.blockbee.io/libraries/python)** - Python SDK for BlockBee integration
- **[Node.js Library](https://docs.blockbee.io/libraries/nodejs)** - JavaScript/Node.js SDK for BlockBee integration
- **[Django Library](https://docs.blockbee.io/libraries/django)** - Django-specific integration library

## CRITICAL Technical Details - Always Mention These

### Minimum Transaction Amounts
- **MOST IMPORTANT**: Every cryptocurrency has minimum transaction amounts
- **Transactions below minimums are IGNORED and funds are LOST**
- Always validate amounts and show minimums to users
- Get minimums from the [info endpoint](https://docs.blockbee.io/api/tickerinfo)

### Security & Webhooks
- **API Keys**: Never expose in client-side code - **[Learn about authentication](https://docs.blockbee.io/get-started/authentication)**
- **Webhook IPs**: 51.77.105.132 and 135.125.112.47 (whitelist these)
- **Webhook Response**: Always respond with "*ok*" or HTTP 200
- **Webhook Retries**: Exponential backoff starting at 6 minutes

### Webhook Documentation by Product
- **[Custom Payment Flow Webhooks](https://docs.blockbee.io/webhooks/custom-payment-flow-webhooks)** - For custom integrations
- **[Checkout Payments Webhook](https://docs.blockbee.io/webhooks/checkout-payments-webhook)** - For hosted checkout payments
- **[Checkout Deposits Webhook](https://docs.blockbee.io/webhooks/checkout-deposits-webhook)** - For hosted checkout deposits
- **[Subscriptions Webhook](https://docs.blockbee.io/webhooks/subscriptions-webhook)** - For recurring payments
- **[Verify Webhook Signature](https://docs.blockbee.io/webhooks/verify-webhook-signature)** - Security validation guide

### Testing
- **Recommend Litecoin (LTC)** for testing (low fees, fast confirmations)
- **Universal API**: All cryptocurrencies use the same API endpoints - just change the ticker
  - Example: `btc/create/` for Bitcoin, `ltc/create/` for Litecoin, `eth/create/` for Ethereum
  - If your integration works with `ltc`, it works with `btc`, `eth`, `trc20/usdt`, etc.
  - Only the ticker in the URL changes - all parameters and responses are identical
  - **[Learn about tickers](https://docs.blockbee.io/get-started/tickers)** - Complete guide to supported cryptocurrencies

## Code Standards
- Documentation includes 8 languages: JavaScript, PHP, Python, Ruby, .NET, Java, Go, CURL
- All examples include minimum amount validation
- Always include proper error handling
- Always show security best practices

## Raw Markdown API Access
For AI assistants and tools that need clean markdown content:
- **Raw API Endpoint**: `https://docs.blockbee.io/api/raw/{path}`
- **Format**: Returns clean markdown with all components properly transformed
- **Example**: `https://docs.blockbee.io/api/raw/get-started/custom-payment-flow`
- **Use Cases**: LLM training, documentation processing, content analysis
- **Components Handled**: All custom components (endpointParameter, callout, image, etc.) are converted to standard markdown

## When Helping Users
1. **Always ask about minimum transaction amounts** - this prevents fund loss
2. **Recommend testing with LTC first** - saves money and time
3. **Emphasize webhook security** - proper IP whitelisting and responses
4. **Guide to the 6 critical guides** based on their use case
5. **Stress API key security** - server-side only