Drop-in payment adapters for connecting e-commerce platforms, AI agent frameworks, and automation tools to AlgoVoi — a compliance-aware crypto payment gateway where agents negotiate a shared stablecoin settlement lane: seven native mainnet chains, with cross-chain settlement negotiated between agents on any two of them. The adapters in this repository are end-to-end tested on the seven native chains (Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo).
AlgoVoi crypto payments via MCP: USDC + native on Algorand, VOI, Hedera, Stellar.
AlgoVoi is compliance-aware payment infrastructure for stablecoin settlement. The same gateway that negotiates settlement across seven native mainnet chains — in any cross-chain pairing among them — also runs continuous sanctions screening, KYB gating, and a write-once SHA-256 audit chain on every payment — so merchants and autonomous agents don't quietly carry UK MLRs / OFAC / SAMLA exposure they didn't sign up for. Compliance posture is published live at /compliance/attestation.
The compliance perimeter is the product. Multi-chain breadth — seven native mainnet chains (Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo), with settlement negotiated between agents on any two of them rather than fixed to one — and protocol coverage (x402, MPP, AP2, A2A) are how we deliver it on a single endpoint, without merchants having to manage wallets or blockchain integrations directly.
Supported settlement assets:
Asset
Network
Details
USDC
Algorand mainnet
Native ASA (ASA ID 31566704), issued by Circle
aUSDC
VOI mainnet
Native ASA (ASA ID 302190), Aramid-bridged USDC
USDC
Hedera mainnet
HTS token 0.0.456858, issued by Circle
USDC
Stellar mainnet
Credit asset issued by Circle (GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN); receiver must have a trust line before accepting
USDC
Base mainnet
ERC-20 token (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913), issued by Circle
USDC
Solana mainnet
SPL token (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v), issued by Circle
USDCe
Tempo mainnet
TIP-20 token (0x20c000000000000000000000b9537d11c60e8b50, 6 decimals); Tempo is a Stripe/Paradigm EVM L1 (chain ID 4217) with USDC as the native gas token
ALGO / VOI / HBAR / XLM / ETH / SOL
Any mainnet
Native coin payments also supported on every chain (6/6/8/7/18/9 decimals respectively)
These seven are the native chains; agents on different chains negotiate a shared lane and settle once, any cross-chain pairing among them. The hosted AlgoVoi pay rail additionally settles natively on Arc, Monad, Polygon, Arbitrum and OP Mainnet. The platform integration guides and adapter smoke tests in this repository cover the seven native chains above.
What is this repository?
This repository contains production-ready payment adapters and integration documentation for connecting e-commerce platforms, custom applications, and AI agent services to AlgoVoi Tenant Services.
Included:
Recurring / standing-authority subscriptions (Recurr/) — Tier 2 lets a customer sign ONCE and AlgoVoi auto-pulls per cycle on all 7 chains (Algorand SpendingCapVault, EVM ERC-20 approve, Solana SPL Approve, Hedera HTS allowance, Stellar Soroban auth_entry, VOI). Per-chain wallet-side reference flows + chain-agnostic merchant-side examples. native-python/algovoi.py v1.2.0+ ships the merchant HTTP wrappers (8 lifecycle methods)
Drop-in plugins for WooCommerce, OpenCart, PrestaShop, and Shopware (tested and deployed)
CMS payment gateways for Drupal Commerce, Easy Digital Downloads (WordPress), and Ghost — all Comet-validated 2026-04-15
Native adapters for PHP, Python, Go, Rust, and TypeScript (zero external dependencies) — all at v1.2.0 with full Tier 2 (recurring) surface
Agent protocol middleware for MPP and AP2 (gate APIs behind payment challenges)
AI platform adapters for OpenAI, Claude, Gemini, Bedrock, Cohere, xAI/Grok, and Mistral (MPP + AP2 + x402, all 7 chains)
AI agent framework adapters for LangChain, LlamaIndex, CrewAI, Hugging Face, AutoGen, Semantic Kernel, Pydantic AI, DSPy, Vercel AI SDK, Google A2A, LangGraph, and Agno — gate LLM-agnostic pipelines, RAG chains, multi-agent crews, and autonomous agents (MPP + AP2 + x402, all 7 chains)
No-code / automation adapters for Zapier, Make (Integromat), n8n, and X (Twitter) — drop-in Python classes that bridge AlgoVoi payment flows into any no-code workflow, with webhook verification, MPP + x402 + AP2 challenge generation, and all 14 networks (7 mainnet + 7 testnet); the X adapter auto-posts payment confirmations and checkout links to X via webhook (OAuth 1.0a, stdlib-only, 4-chain mainnet verified 2026-04-18)
MCP server (@algovoi/mcp-server / algovoi-mcp) — exposes 13 AlgoVoi tools natively inside Claude Desktop, Claude Code, Cursor, and Windsurf via the Model Context Protocol
x402 embeddable widget for any HTML page (Cloudflare Pages)
Integration guides and Python adapters for 45+ platforms — all end-to-end tested on api.algovoi.co.uk across all 7 chains
AlgoVoi Cloud — No-Code Dashboard
The fastest way to accept stablecoin payments — no server access or code required. dash.algovoi.co.uk is the hosted SaaS version of AlgoVoi: sign up with your email, verify your identity, and connect your platforms through a guided dashboard wizard. Each wizard takes under 5 minutes.
The following adapters have been end-to-end tested against a live AlgoVoi tenant on algorand_mainnet, voi_mainnet, hedera_mainnet, stellar_mainnet, base_mainnet, and solana_mainnet:
Platform
Demo store / notes
Hosted chains
Extension chains
OpenCart 4
your-domain.example
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
Algorand, VOI
PrestaShop 8.2.5
your-domain.example
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
Algorand, VOI
Shopware 6.7.8.2
your-domain.example
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
Algorand, VOI
WooCommerce 10.6.2 / WordPress 6.9.4
your-domain.example
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
Algorand, VOI
Shopify (Cloudflare Pages)
algovoi-3.myshopify.com
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Magento 2 / Adobe Commerce
—
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Amazon SP-API
— (B2B webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
TikTok Shop
— (B2B webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Squarespace
— (B2B webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Wix eCommerce
— (SPI checkout)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Native PHP
—
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
Algorand, VOI
Native Python
—
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
Algorand, VOI
Native Go
—
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
Algorand, VOI
Native Rust
—
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
Algorand, VOI
AlgoVoi 1.0
api.algovoi.co.uk/shop-demo
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
Algorand, VOI
QuickBooks Online
— (B2B webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Xero
— (B2B webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
FreshBooks
— (B2B webhook, form-urlencoded + fetch_order)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Sage Business Cloud
— (polling, no push webhooks)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Zoho Books
— (B2B webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Wave
— (B2B webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
MYOB
— (polling, no push webhooks)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
eBay
— (Platform Notifications webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Ecwid / Lightspeed E-Series
— (B2B webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Etsy
— (B2B webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Rakuten Ichiba
— (B2B webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
OnBuy
— (B2B webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Yapily
— (open banking webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Walmart Marketplace
— (B2B webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
CeX
— (operator bypass webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Printful
— (print-on-demand webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Wormhole
— (cross-chain bridge webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
WhatsApp Business
— (Meta webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Instagram Shops
— (Meta webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Telegram
— (Bot API webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Allegro
— (marketplace webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Bol.com
— (marketplace webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Cdiscount
— (marketplace webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Flipkart
— (Seller API webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Lazada
— (open platform webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Mercado Libre
— (marketplace webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Shopee
— (open platform webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Tokopedia
— (marketplace webhook)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
— (webhook adapter + OAuth 1.0a tweet posting; auto-posts payment confirmations & checkout links when AlgoVoi fires a webhook; 62/62 unit tests; 4-chain mainnet e2e verified 18 Apr 2026; Base + Solana added 2026-04-22/23; Tempo added 2026-04-23 — payments confirmed on-chain, tweets posted automatically)
Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
—
Last webhook test: 14 April 2026 — all 39 testable adapters passed on all 4 original chains (algorand_mainnet, voi_mainnet, hedera_mainnet, stellar_mainnet); Base and Solana added 2026-04-22/23. Checkout pages validated live via Comet CDP. 6 adapters skipped: BigCommerce (partial — order-amount fetch needs real API credentials), Discord (Ed25519), TrueLayer (ES512), Faire/Jumia/Printify (docs only).
AI agent adapters — production ready as of 13 April 2026:
x402: spec v1 compliant — x402Version: 1, accepts array, CAIP-2 network IDs, string microunit amounts, payload.signature proof format. Real payments smoke-tested on all 4 original chains (Algorand, VOI, Stellar, Hedera mainnet); Base and Solana added 2026-04-22/23. x402/verify confirmed verified:true on each. 76/76 unit tests passing. Adapter v2.0.0.
MPP: 100% IETF spec compliant (v2.1.0) — id (HMAC-SHA256), method, intent="charge", request= (charge intent object), expires, challenge echo validation (Table 3), CAIP-2 network routing, replay protection, spec-compliant Payment-Receipt. On-chain verification smoke-tested on all 4 original chains (Algorand, VOI, Hedera, Stellar) 13 Apr 2026 ×2; Base and Solana added 2026-04-22/23. 153/153 unit tests.
AP2: production ready (v2.0.0) — AP2 v0.1 CartMandate/PaymentMandate with AlgoVoi crypto-algo extension. CartMandate issues PaymentMethodData per extension schema (network, receiver, amount_microunits, asset_id, min_confirmations, memo_required). PaymentMandate accepts payment_response.details.{network, tx_id, note_field}. ed25519 sig + on-chain AVM verification. PyNaCl + cryptography fallback both confirmed. 81/81 tests.
Two payment flows
Hosted checkout — Customer is redirected to a secure AlgoVoi-hosted payment page. Supports Algorand, VOI, Hedera, Stellar, Base, Solana, and Tempo. Works with any wallet (Pera, Defly, Lute, HashPack, Freighter, LOBSTR, MetaMask, Phantom, …). Payment confirmed via webhook or API status check. Used by all platforms including Shopify.
Extension payment — Customer pays directly on the store page using the AlgoVoi browser extension and algosdk. Supports Algorand and VOI only (AVM chains). Buyers paying on Hedera or Stellar use hosted checkout with their chain-native wallet. No redirect required for extension flow. Available on WooCommerce, OpenCart, PrestaShop, and Shopware.
Shopify checkout extension — "Pay with Crypto →" link rendered on the thank-you page via Shopify Checkout UI Extension (Preact). Customer selects their chain on a dedicated pay page. Webhook automatically adds payment link to order notes.
Drop-in payment gateways for major content-management and publishing platforms. All three were shipped together on 15 April 2026 and Comet-validated end-to-end. Each adapter applies the full April 2026 + pass-2 hardening set (cancel-bypass guard, empty-secret HMAC reject, timing-safe compare, 64 KB body cap, https-only outbound, amount sanity, scheme guards, token length caps, mandatory payment cross-check on webhooks).
Available — grant-on-payment member upgrade, v1.0.0
Each adapter folder ships a README.md with a how-it-works diagram, quick-start, supported chains, webhook endpoint, security posture table, and dependency list.
Regional & international marketplace integrations
All regional marketplace adapters have been end-to-end tested on 14 April 2026 across all 4 original chains; Base and Solana added 2026-04-22/23. Checkout pages validated live via Comet CDP.
All 7 accounting adapters are end-to-end tested on 14 April 2026 against api.algovoi.co.uk across all 4 original chains (28/28 pass); Base and Solana added 2026-04-22/23.
Adapter source is not publicly distributed. Integration guides are below. Download your adapter from the AlgoVoi dashboard after signing in with your API key.
Autonomous AI agent payments via the x402 protocol (spec v1 — accepts array, CAIP-2 IDs, microunit amounts, payload.signature)
Production ready — real payments smoke-tested on all 4 original chains (Algorand, VOI, Stellar, Hedera); Base and Solana added 2026-04-22/23, x402/verify confirmed on each. Adapter v2.0.0, 76/76 tests.
Production ready — 0.01 USDC live smoke-tested on all 4 original chains (Algorand, VOI, Hedera, Stellar) 13 Apr 2026; Base and Solana added 2026-04-22/23. Adapter v2.1.0, 153/153 tests.
AP2 v0.1 CartMandate/PaymentMandate server middleware with AlgoVoi crypto-algo extension. ed25519 mandate signing + on-chain tx verification across all 7 chains (Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo).
Production ready — 0.01 USDC live smoke-tested on all 4 original chains 13 Apr 2026; Base + Solana added 2026-04-22/23; Tempo added 2026-04-23. Real ed25519 sig verified. v2.0.0, 81/81 tests.
AI Platform Adapters
Drop-in payment gates for AI provider APIs. Each adapter wraps the AI call behind an on-chain payment check — the caller pays 0.01 USDC (or any configured amount) before the AI responds. All adapters accept OpenAI-format message lists and share a common interface: check(headers, body) → result, complete(messages) → str, flask_guard() convenience method.
OpenAI-format messages work across all seven platforms — system roles are extracted automatically where required (Claude, Bedrock), Gemini assistant roles are mapped to model internally, and Cohere, xAI, and Mistral all accept the system role natively via their respective SDKs.
AI Agent Framework Adapters
Gate entire orchestration frameworks behind on-chain payment — not just a single model provider. These adapters are LLM-agnostic: pass any pre-built ChatModel, LCEL chain, RAG pipeline, or ReAct agent and the payment check wraps the whole thing.
The tool accepts {"query": "...", "payment_proof": "<base64>"}. Returns a challenge JSON dict if proof is absent or invalid; calls resource_fn(query) and returns the result if verified.
The tool accepts {"query": "...", "payment_proof": "<base64>"}. Returns a ToolOutput with .content (challenge JSON or resource result), .tool_name, .raw_input, .raw_output.
Bring your own LlamaIndex LLM (Anthropic, Google, Cohere, Bedrock, etc.):
The tool uses PaymentToolInput (Pydantic args_schema) — the agent generates {"query": "...", "payment_proof": "<base64>"}, CrewAI validates it, and _run(query, payment_proof) is called directly as kwargs. Any crewai.LLM provider (OpenAI, Anthropic, Gemini, Bedrock, Groq, Together AI, …) is supported via the LiteLLM router.
from huggingface_algovoi import AlgoVoiHuggingFace
gate = AlgoVoiHuggingFace(
hf_token = "hf_...",
algovoi_key = "algv_...",
tenant_id = "your-tenant-uuid",
payout_address = "YOUR_ALGORAND_ADDRESS",
protocol = "mpp",
network = "algorand-mainnet",
amount_microunits = 10000,
model = "meta-llama/Meta-Llama-3-8B-Instruct",
)
# Gate InferenceClient.chat_completion()
result = gate.check(headers, body)
if not result.requires_payment:
reply = gate.complete(body["messages"])
# Gate a transformers pipeline
from transformers import pipeline
pipe = pipeline("text-generation", model="HuggingFaceH4/zephyr-7b-beta", token="hf_...")
if not result.requires_payment:
answer = gate.inference_pipeline(pipe, body["messages"])
Drop into a smolagents ToolCallingAgent:
from smolagents import ToolCallingAgent, InferenceClientModel
tool = gate.as_tool(resource_fn=my_handler, tool_name="premium_kb")
model = InferenceClientModel(model_id="meta-llama/Meta-Llama-3-8B-Instruct")
agent = ToolCallingAgent(tools=[tool], model=model)
agent.run("Use premium_kb to answer my question.")
The tool accepts query and payment_proof (base64) as kwargs. Returns challenge JSON if proof absent/invalid; calls resource_fn(query) and returns the result if verified. Works with any smolagents agent type (ToolCallingAgent, CodeAgent, custom).
from semantic_kernel_algovoi import AlgoVoiSemanticKernel
gate = AlgoVoiSemanticKernel(
openai_key = "sk-...",
algovoi_key = "algv_...",
tenant_id = "your-tenant-uuid",
payout_address = "YOUR_ALGORAND_ADDRESS",
protocol = "mpp",
network = "algorand-mainnet",
amount_microunits = 10000,
model = "gpt-4o",
)
# Gate SK chat completion (sync wrapper around async SK API)
result = gate.check(headers, body)
if not result.requires_payment:
reply = gate.complete(body["messages"])
# Gate any KernelFunction
output = gate.invoke_function(kernel, summarise_fn, input=body["text"])
Add as a @kernel_function plugin:
plugin = gate.as_plugin(resource_fn=my_handler, plugin_name="premium_kb")
kernel.add_plugin(plugin, plugin_name="premium_kb")
# The LLM can select plugin.gate() via function calling (auto-invocation)
The gate function accepts query and payment_proof (base64). Returns challenge JSON if proof absent/invalid; calls resource_fn(query) and returns the result if verified.
The tool accepts query and payment_proof (base64). Returns challenge JSON if proof absent/invalid; calls resource_fn(query) if verified. Supports all Pydantic AI providers — OpenAI, Anthropic, Google, Groq, Ollama, and any OpenAI-compatible endpoint via base_url.
from dspy_algovoi import AlgoVoiDSPy
gate = AlgoVoiDSPy(
openai_key = "sk-...",
algovoi_key = "algv_...",
tenant_id = "your-tenant-uuid",
payout_address = "YOUR_ALGORAND_ADDRESS",
protocol = "mpp",
network = "algorand-mainnet",
amount_microunits = 10000,
model = "openai/gpt-4o", # DSPy provider/model string (slash, not colon)
)
# Gate any DSPy module
import dspy
class QA(dspy.Signature):
"""Answer the question."""
question: str = dspy.InputField()
answer: str = dspy.OutputField()
result = gate.check(headers, body)
if not result.requires_payment:
answer = gate.run_module(dspy.ChainOfThought(QA), question=body["question"])
Gate a compiled DSPy program:
# Works with any compiled / optimised DSPy program (Predict, ChainOfThought, ReAct, MIPROv2…)
result = gate.run_module(my_compiled_program, question=body["question"])
Drop into a ReAct agent as a plain callable tool:
tool = gate.as_tool(resource_fn=my_handler, tool_name="premium_kb")
react = dspy.ReAct(QA, tools=[tool])
lm = gate._ensure_lm()
with dspy.context(lm=lm):
out = react(question=body["question"])
All LLM calls use dspy.context(lm=...) — global dspy.configure() state is never modified. DSPy's provider/model string format is supported for OpenAI, Anthropic, Google, Cohere, Groq, Ollama, and Azure OpenAI.
Drop-in Python classes that bridge AlgoVoi crypto payment flows into Zapier, Make (Integromat), and n8n — the three leading no-code / low-code automation platforms. Each adapter is a single file with zero external dependencies (stdlib HTTP only), mirrors the native Python adapter pattern, and applies the full April 2026 + pass-2 security hardening.
All three adapters were shipped on 17 April 2026 and are Comet-validated end-to-end.
Supported across all 14 networks (7 mainnet + 7 testnet) on Algorand, VOI, Hedera, Stellar, Base, Solana, and Tempo. All three adapters support MPP, x402, and AP2 challenge generation.
Zapier — Quick start
from zapier_algovoi import AlgoVoiZapier
handler = AlgoVoiZapier(
algovoi_key = "algv_...",
tenant_id = "your-tenant-uuid",
payout_algorand= "YOUR_ALGORAND_ADDRESS",
webhook_secret = "whsec_...", # optional
zapier_hook_url= "https://hooks.zapier.com/hooks/catch/XXXX/YYYY/", # optional
)
# Create a payment link (Zapier action)
result = handler.action_create_payment_link({
"amount": 5.00,
"currency": "USD",
"label": "Premium access",
"network": "algorand_mainnet",
})
# result.success, result.data["checkout_url"], result.data["token"]
# Verify payment status
result = handler.action_verify_payment({"token": "tok_..."})
# result.data["paid"] → True/False, result.data["status"] → "active"|"paid"|...
# Receive and forward an AlgoVoi webhook to a Zapier Catch Hook
result = handler.receive_and_forward(raw_body=..., signature=...)
# Generate MPP / x402 / AP2 challenge
result = handler.action_generate_challenge({
"protocol": "mpp", # "mpp" | "x402" | "ap2"
"resource_id": "/api/premium",
"amount_microunits": 10_000,
"network": "algorand_mainnet",
})
An MCP (Model Context Protocol) server that exposes AlgoVoi's payment infrastructure as tools directly inside Claude Desktop, Claude Code, Cursor, Windsurf, and any other MCP-compatible AI assistant. Ships as two packages — pick whichever runtime your client supports:
Package
Install
Command
@algovoi/mcp-server (npm)
npm i -g @algovoi/mcp-server
npx -y @algovoi/mcp-server
algovoi-mcp (PyPI)
pip install algovoi-mcp
uvx algovoi-mcp
13 built-in tools
#
Tool
What it does
1
create_payment_link
Create a hosted-checkout URL for a given amount and chain
2
verify_payment
Verify a checkout token (optionally with a tx_id)
3
prepare_extension_payment
In-page wallet-flow params (Algorand / VOI)
4
verify_webhook
HMAC-SHA256 signature check for AlgoVoi webhooks
5
list_networks
Supported chains + asset IDs (offline, no API call)
Single-chain users only need to set the env var for their chain — the others are optional. For Base use ALGOVOI_PAYOUT_BASE; for Solana use ALGOVOI_PAYOUT_SOLANA. For the Python package, swap "command": "uvx", "args": ["algovoi-mcp"].
Config file locations: Claude Desktop%APPDATA%\Claude\claude_desktop_config.json (Windows) / ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · Claude Code~/.claude.json · Cursor~/.cursor/mcp.json
Pre-built, self-contained donation pages powered by AlgoVoi and deployed to Cloudflare Pages. Zero external dependencies — drop the HTML file onto any server or share the URL directly.
A drop-in Web Component for accepting x402 payments on any website. Deployed to Cloudflare Pages at your-domain.example. Full source and security guide: x402-widget/
Six adapters have structural blockers that prevent full end-to-end testing:
Adapter
Blocker
BigCommerce
Webhook signature verifies correctly, but GET /v2/orders/{id} for order amount requires a real store_hash and access_token. All other flow steps work.
Discord
Uses Ed25519 asymmetric signing — cannot sign test webhooks without a real Discord application keypair.
TrueLayer
Uses ES512 JWK signing — cannot sign test webhooks without a real TrueLayer private key.
Faire
Requires Faire API approval before any developer access.
Jumia
Documentation only — no webhook endpoint is publicly available.
Printify
Documentation only — no webhook endpoint is publicly available.
How payments work
Customer places order and selects chain (Algorand / VOI / Hedera / Stellar / Base / Solana)
↓
Plugin creates payment link via POST /v1/payment-links
↓
Hosted: redirect to AlgoVoi checkout page
Extension: pay in-page via AlgoVoi browser wallet
↓
Customer pays on-chain
↓
AlgoVoi verifies the transaction on-chain
↓
Webhook fires → order marked as paid in your platform
Payments are verified directly on-chain — no intermediary holds funds. Settlement goes straight to the merchant's configured payout address.
Security
Every adapter is hardened against real-world payment attack vectors. Pass 1 (April 2026) covered cancel-bypass / empty-secret / cookie-swap / SSRF / timing attacks across all deployed stores and native adapters. Pass 2 (15 April 2026) added defensive depth across the B2B webhook trio + native SDKs + a critical Rust compile fix.
Vulnerabilities found and fixed — Pass 1 (April 2026)
Vulnerability
Severity
Affected
Fix
Cancel-bypass
Critical
Shopware, PrestaShop (hosted)
finalize() / confirm.php now call GET /checkout/{token} and only mark paid if status is paid/completed/confirmed
Webhook empty-secret
High
OpenCart, Shopware
Reject with HTTP 500 before HMAC check if webhook_secret is empty — prevents hash_hmac('sha256', $body, '', true) forgery
Cookie-swap attack
High
PrestaShop (extension)
verify.php cross-checks id_customer against logged-in customer before marking order as paid
SSRF on checkout URL
Medium
All platforms
parse_url() host comparison before any server-side fetch of checkout page
Timing attack
Medium
WooCommerce
hash_equals() for order_key comparison instead of !==
Missing SSL verification
Medium
OpenCart, PrestaShop
CURLOPT_SSL_VERIFYPEER => true and CURLOPT_SSL_VERIFYHOST => 2 on all curl calls
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
सवाल
Algovoi कैसे इंस्टॉल करें?
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
क्या Algovoi के लिए API key चाहिए?
पब्लिशर ने ये एनवायरनमेंट वेरिएबल बताए हैं: ALGOVOI_API_KEY, ALGOVOI_API_BASE, ALGOVOI_TENANT_ID, ALGOVOI_PAYOUT_ADDRESS, ALGOVOI_WEBHOOK_SECRET।
Algovoi कौन सा ट्रांसपोर्ट इस्तेमाल करता है?
Algovoi stdio पर लोकल चलता है।
Algovoi की पिछली जाँच कब हुई थी?
पिछली जाँच 2026-11-09 को हुई। AlgoVoi crypto payments via MCP: USDC + native on Algorand, VOI, Hedera, Stellar.