# CoinCircuit

> CoinCircuit is crypto payment infrastructure for African and global businesses. Accept crypto payments, move stablecoins with business wallets, create static deposit addresses, onramp and offramp stablecoins, and send global payouts. Build agentic workflows and accept payments from AI agents using our MCP server and infrastructure.

## What is CoinCircuit?

CoinCircuit is crypto payment infrastructure founded in Nigeria in 2023. It enables businesses to accept crypto payments via hosted checkout, payment links, and a REST API, and to build agentic workflows where AI agents pay and get paid through a Model Context Protocol (MCP) server.

Key differentiators:
- **African-first**: Built specifically for Nigeria, Ghana, Kenya, South Africa, and the wider African market
- **Agentic**: Build agentic workflows and accept payments from AI agents using our MCP server and x402 support
- **HTTP 402 support**: Enables AI agents to resolve payment-gated API responses automatically
- **Multi-chain**: Supports Ethereum, BSC, Polygon, Tron, Solana, and more
- **1% transaction fee**: Transparent flat-rate pricing

## Pages

- [Home](https://coincircuit.io/): Overview of CoinCircuit crypto payment infrastructure, pricing, and integrations
- [Features](https://coincircuit.io/features): Smart routing, hosted checkout, analytics, webhooks, settlements
- [Business](https://coincircuit.io/business): How merchants accept crypto payments with CoinCircuit
- [Developer Docs](https://coincircuit.io/docs): Integration guides, SDKs, quickstart tutorials
- [API Reference](https://coincircuit.io/api-reference): Full REST API endpoint documentation
- [OpenAPI Spec (JSON)](https://coincircuit.io/openapi.json): Raw OpenAPI 3.0 specification, all endpoints, schemas, authentication, and examples
- [AI / Agentic Payments](https://coincircuit.io/ai): MCP server for AI agent crypto payments, HTTP 402 resolution
- [Blog](https://coincircuit.io/blog): Articles on agentic crypto payments, African fintech, and Web3
- [FAQ](https://coincircuit.io/faq): Common questions about fees, currencies, integration, and settlements
- [About](https://coincircuit.io/about): Company background, mission, and team
- [Security](https://coincircuit.io/security): AES-256, TLS 1.3, OAuth 2.0, security audits
- [Changelog](https://coincircuit.io/api-reference?tab=changelog): API version history and migration guides

## Guides

Integration guides from the developer docs, one topic each. Every guide has a markdown twin at the same address plus .md, and an interactive version at https://coincircuit.io/api-reference?tab=guides.

### Getting Started

- [Introduction](https://coincircuit.io/docs/guides/introduction/): Accept crypto payments, send payouts, and issue refunds through one API. (markdown: https://coincircuit.io/docs/guides/introduction.md)
- [MCP Integration](https://coincircuit.io/docs/guides/mcp/): Connect AI IDEs to CoinCircuit through MCP. (markdown: https://coincircuit.io/docs/guides/mcp.md)
- [Authentication](https://coincircuit.io/docs/guides/authentication/): Authenticate requests, handle rate limits and errors. (markdown: https://coincircuit.io/docs/guides/authentication.md)
- [Sandbox Environment](https://coincircuit.io/docs/guides/sandbox/): Test safely with sandbox keys and testnet faucets. (markdown: https://coincircuit.io/docs/guides/sandbox.md)

### Accepting Payments

- [Payments](https://coincircuit.io/docs/guides/checkout-sessions/): Accept one-time crypto payments online. (markdown: https://coincircuit.io/docs/guides/checkout-sessions.md)
- [E-Commerce Plugins](https://coincircuit.io/docs/guides/ecommerce-plugins/): Accept crypto in your WooCommerce or OpenCart store with a plugin. (markdown: https://coincircuit.io/docs/guides/ecommerce-plugins.md)
- [Invoices](https://coincircuit.io/docs/guides/invoices/): Generate itemized invoices payable in crypto. (markdown: https://coincircuit.io/docs/guides/invoices.md)
- [Refunds](https://coincircuit.io/docs/guides/refunds/): Refund paid sessions and invoice. (markdown: https://coincircuit.io/docs/guides/refunds.md)
- [Payment Pages](https://coincircuit.io/docs/guides/payment-pages/): Static payment pages with permanent links and QR codes. (markdown: https://coincircuit.io/docs/guides/payment-pages.md)
- [POS Terminals](https://coincircuit.io/docs/guides/pos-terminals/): Accept in-person crypto payments at the point of sale. (markdown: https://coincircuit.io/docs/guides/pos-terminals.md)
- [Deposit Accounts](https://coincircuit.io/docs/guides/deposit-accounts/): Static deposit addresses and NGN virtual accounts per customer. (markdown: https://coincircuit.io/docs/guides/deposit-accounts.md)
- [Dynamic Settlement](https://coincircuit.io/docs/guides/dynamic-settlement/): Choose the currency each payment and deposit account is settled into. (markdown: https://coincircuit.io/docs/guides/dynamic-settlement.md)
- [x402 Payments](https://coincircuit.io/docs/guides/x402/): Gate HTTP routes behind crypto payments using the x402 protocol. (markdown: https://coincircuit.io/docs/guides/x402.md)

### Payouts & Swaps

- [Payouts](https://coincircuit.io/docs/guides/payouts/): Withdraw your balance to a bank account or any crypto wallet. (markdown: https://coincircuit.io/docs/guides/payouts.md)
- [Swaps](https://coincircuit.io/docs/guides/swaps/): Convert between fiat and stablecoins on your balance (on and off ramp). (markdown: https://coincircuit.io/docs/guides/swaps.md)

### Pricing & Limits

- [Fees](https://coincircuit.io/docs/guides/fees/): What CoinCircuit charges per payment, payout, and refund. (markdown: https://coincircuit.io/docs/guides/fees.md)
- [Limits](https://coincircuit.io/docs/guides/limits/): Single-transaction and daily limits for payouts and swaps. (markdown: https://coincircuit.io/docs/guides/limits.md)

### Migration

- [Migrate from NOWPayments](https://coincircuit.io/docs/guides/migrate-from-nowpayments/): Move from NOWPayments to CoinCircuit: endpoint mapping, webhook re-signing, and a step-by-step checklist. (markdown: https://coincircuit.io/docs/guides/migrate-from-nowpayments.md)
- [Migrate from Triple-A](https://coincircuit.io/docs/guides/migrate-from-triplea/): Move from Triple-A to CoinCircuit: swap OAuth2 for an API key, update webhook signing, and map every field. (markdown: https://coincircuit.io/docs/guides/migrate-from-triplea.md)
- [Migrate from Cryptomus](https://coincircuit.io/docs/guides/migrate-from-cryptomus/): Move from Cryptomus to CoinCircuit: swap request signing for an API key, update webhook verification, and map every field. (markdown: https://coincircuit.io/docs/guides/migrate-from-cryptomus.md)

### Build with AI

- [E-Commerce Crypto Checkout](https://coincircuit.io/docs/guides/ecommerce-checkout/): Accept crypto at checkout with the embedded SDK and order webhooks. (markdown: https://coincircuit.io/docs/guides/ecommerce-checkout.md)
- [Stablecoin On/Off-Ramp](https://coincircuit.io/docs/guides/stablecoin-onramp-offramp/): Convert between fiat (NGN) and stablecoins (USDC or USDT). (markdown: https://coincircuit.io/docs/guides/stablecoin-onramp-offramp.md)
- [Crypto Payouts](https://coincircuit.io/docs/guides/crypto-payouts/): Send USDT payouts to any crypto wallet. (markdown: https://coincircuit.io/docs/guides/crypto-payouts.md)
- [Customer Deposit Accounts](https://coincircuit.io/docs/guides/customer-deposit-accounts/): Give each customer reusable crypto addresses and a bank account to fund their balance. (markdown: https://coincircuit.io/docs/guides/customer-deposit-accounts.md)
- [SaaS Invoice Billing](https://coincircuit.io/docs/guides/saas-invoicing/): Bill subscriptions with crypto invoices, expiry timers, and partial payments. (markdown: https://coincircuit.io/docs/guides/saas-invoicing.md)
- [Marketplace Vendor Payouts](https://coincircuit.io/docs/guides/marketplace-settlement/): Collect crypto from buyers and pay vendors out in crypto. (markdown: https://coincircuit.io/docs/guides/marketplace-settlement.md)
- [Donation / Tip Page](https://coincircuit.io/docs/guides/donation-page/): Accept crypto donations or tips with a shareable page. (markdown: https://coincircuit.io/docs/guides/donation-page.md)
- [Telegram Bot Crypto Payments](https://coincircuit.io/docs/guides/telegram-subscription-bot/): Take crypto payments in a Telegram bot for subscriptions or access. (markdown: https://coincircuit.io/docs/guides/telegram-subscription-bot.md)
- [x402 API Monetization](https://coincircuit.io/docs/guides/x402-api-monetization/): Charge AI agents per request over HTTP 402 with gasless stablecoin payments. (markdown: https://coincircuit.io/docs/guides/x402-api-monetization.md)
- [Refund & Dispute Handling](https://coincircuit.io/docs/guides/refund-management/): Refund checkout sessions and invoices in crypto. (markdown: https://coincircuit.io/docs/guides/refund-management.md)

## Machine-readable resources

- [llms-full.txt](https://coincircuit.io/llms-full.txt): Every page of this site as one markdown document
- Markdown copy of any page: append `.md` to its path, for example https://coincircuit.io/pricing.md or https://coincircuit.io/docs/guides.md (the homepage is https://coincircuit.io/index.md)
- [API catalog](https://coincircuit.io/.well-known/api-catalog): RFC 9727 linkset pointing at the spec, docs and health endpoints
- [auth.md](https://coincircuit.io/auth.md): How agents obtain and use API credentials
- [MCP server](https://mcp.coincircuit.io): Model Context Protocol server for agent payments

## Blog Articles

- [Crypto Payments Across Africa: Five Markets, Five Payment Stacks](https://coincircuit.io/blog/crypto-payments-africa/)
- [Crypto Payments in Nigeria: Why Your Business Should Accept Crypto](https://coincircuit.io/blog/accept-crypto-payments-nigeria/)
- [Stablecoins vs CBDCs: What the Data Says for African Fintech Builders](https://coincircuit.io/blog/stablecoins-vs-cbdcs/)
- [The Multi-Chain Merchant: Why Your Customers Are on Different Blockchains and What to Do About It](https://coincircuit.io/blog/multi-chain-merchant-conversion-rates/)
- [How to Sign a Gasless Stablecoin Payment](https://coincircuit.io/blog/how-to-sign-gasless-payment/)
- [x402: How to Accept Payments from AI Agents on Your API](https://coincircuit.io/blog/x402-machine-to-machine-payments/)
- [The Agentic Web: Why AI Assistants Need Crypto Rails to Function](https://coincircuit.io/blog/ai-assistants-crypto-rails/)

## Contact

- Website: https://coincircuit.io
- Email: contact@coincircuit.io
- Support: support@coincircuit.io
- Twitter/X: https://twitter.com/coincircuithq
- LinkedIn: https://www.linkedin.com/company/coincircuithq
- Telegram: https://t.me/coincircuithq
- GitHub: https://github.com/CoinCircuit
- PyPI: https://pypi.org/project/coincircuit/