# AlgoVoi Gateway API

**Canonical:** https://apis.io/apis/algovoi-co-uk/algovoi-gateway-api/  
**Provider:** AlgoVoi — https://apis.io/providers/algovoi-co-uk/  
**Base URL:** https://api.algovoi.co.uk  
**Documentation:** https://docs.algovoi.co.uk/api-reference/introduction

AlgoVoi Gateway API is one of 6 APIs that [AlgoVoi](https://apis.io/providers/algovoi-co-uk/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Payments, Agentic Commerce, x402, MPP, and AP2. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

The multi-tenant payment gateway (OpenAPI 3.1.0 "AlgoVoi Gateway" 1.0.0-phase1c, 115 operations, 99 schemas) at api.algovoi.co.uk: hosted checkout links and the checkout lifecycle (QR, build/submit txn, detect, status, cancel, abandon, cross-chain bridge), x402 and MPP gated resources and subscriptions, the AP2 mandate chain (intent/cart/pay/confirm/status), an A2A surface (message:send, tasks, pushNotificationConfigs, /a2a/jsonrpc, /a2a/gibberlink), customers, subscriptions, Tier 2 recurring authorities and hosted authorisation, payouts, compliance screening and a public compliance attestation, receipt and RFC 9421 verification, the suite store, signup proxies and the Agentic Payment Mandates portal. Authenticated with a tenant Bearer key (algv_) plus X-Tenant-Id; 300 req/min per tenant with X-RateLimit-* headers; Idempotency-Key on creates; Stripe-shaped HMAC-signed webhooks.

## Operations (60 of 115)

| Method | Path | Summary |
|---|---|---|
| GET | `/health` | Health |
| POST | `/auth/token` | Exchange Atb Cert |
| GET | `/auth/token/status` | Session Status |
| POST | `/v1/verify` | MPP payment verification |
| POST | `/v1/ap2/verify` | AP2 mandate verification |
| POST | `/v1/payouts` | Initiate on-chain payout |
| POST | `/mpp/challenge` | Mpp Challenge |
| GET | `/mpp/probe` | Mpp Probe |
| PUT | `/mpp/probe` | Mpp Probe |
| POST | `/mpp/probe` | Mpp Probe |
| DELETE | `/mpp/probe` | Mpp Probe |
| OPTIONS | `/mpp/probe` | Mpp Probe |
| HEAD | `/mpp/probe` | Mpp Probe |
| PATCH | `/mpp/probe` | Mpp Probe |
| GET | `/mpp/{resource_id}` | Mpp Resource |
| POST | `/mpp/sub/{resource_id}` | Mpp Subscription Resource |
| GET | `/mpp/sub/{resource_id}` | Mpp Subscription Resource |
| POST | `/ap2/intent` | Submit an IntentMandate to open an AP2 shopping session |
| POST | `/ap2/cart` | Submit a merchant-signed CartMandate, verified against an accepted IntentMandate |
| POST | `/ap2/pay` | Submit PaymentMandate; verify user_authorization and return crypto challenge |
| POST | `/ap2/confirm` | Confirm on-chain transaction; gateway verifies via facilitator and issues JWT |
| GET | `/ap2/status/{cart_id}` | Inspect AP2 mandate chain state by cart_id |
| GET | `/ap2/extensions` | List AP2 extensions supported by this gateway |
| GET | `/ext/scoped-authorization-receipts/v1` | Scoped Auth Receipts Profile |
| HEAD | `/ext/scoped-authorization-receipts/v1` | Scoped Auth Receipts Profile |
| GET | `/extendedAgentCard` | Extended Agent Card |
| POST | `/message:send` | Send Message |
| POST | `/message:stream` | Message Stream |
| GET | `/tasks/{task_id}/pushNotificationConfigs/{config_id}` | Push Notification Config |
| DELETE | `/tasks/{task_id}/pushNotificationConfigs/{config_id}` | Push Notification Config |
| POST | `/tasks/{task_id}/pushNotificationConfigs` | Push Notification Config |
| GET | `/tasks/{task_id}/pushNotificationConfigs` | Push Notification Config |
| GET | `/tasks/{task_id}` | Get Task |
| POST | `/tasks/{task_id}:cancel` | Cancel Task |
| GET | `/tasks` | List Tasks |
| POST | `/a2a/jsonrpc` | A2A Jsonrpc |
| POST | `/a2a/gibberlink` | A2A Gibberlink |
| POST | `/v1/payment-links` | Create a dynamic payment link |
| POST | `/v1/customers` | Create Customer Endpoint |
| GET | `/v1/customers` | List Customers Endpoint |
| POST | `/v1/subscriptions` | Create Subscription Endpoint |
| GET | `/v1/subscriptions` | List Subscriptions Endpoint |
| GET | `/v1/subscriptions/{subscription_id}` | Get Subscription Endpoint |
| PATCH | `/v1/subscriptions/{subscription_id}` | Update Subscription Endpoint |
| POST | `/v1/subscriptions/{subscription_id}/cancel` | Cancel Subscription Endpoint |
| POST | `/v1/subscriptions/{subscription_id}/pause` | Pause Subscription Endpoint |
| POST | `/v1/subscriptions/{subscription_id}/resume` | Resume Subscription Endpoint |
| GET | `/v1/subscriptions/{subscription_id}/invoices` | List Subscription Invoices Endpoint |
| GET | `/subscription/{cancel_secret}/cancel` | Public Cancel Page |
| POST | `/subscription/{cancel_secret}/cancel` | Public Cancel Commit |
| POST | `/v1/recurr/auth/challenge` | Challenge Endpoint |
| POST | `/v1/recurr/auth/verify` | Verify Endpoint |
| GET | `/v1/recurr/me/subscriptions` | My Subscriptions |
| GET | `/v1/recurr/me/subscriptions/{subscription_id}` | My Subscription Detail |
| POST | `/v1/recurr/me/subscriptions/{subscription_id}/cancel` | My Subscription Cancel |
| GET | `/v1/recurr/me/invoices` | My Invoices |
| GET | `/recurr/portal` | Portal Page |
| GET | `/recurr/cancel/{cancel_secret}` | Public Cancel Page |
| POST | `/recurr/cancel/{cancel_secret}` | Public Cancel Commit |
| POST | `/v1/recurring/authorities` | Create Authority Endpoint |

…and 55 more operations. They are listed in full on the page.

## Machine-readable artifacts (25)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/openapi/algovoi-co-uk-gateway-openapi.yml
- **OpenAPI** — https://api.algovoi.co.uk/openapi.json
- **Documentation** — https://docs.algovoi.co.uk/api-reference/introduction
- **APIReference** — https://docs.algovoi.co.uk/api-reference/introduction
- **GettingStarted** — https://docs.algovoi.co.uk/quickstart
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/authentication/algovoi-co-uk-authentication.yml
- **Authentication** — https://docs.algovoi.co.uk/api-reference/authentication
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/conventions/algovoi-co-uk-conventions.yml
- **Idempotency** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/conventions/algovoi-co-uk-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/errors/algovoi-co-uk-problem-types.yml
- **ErrorCodes** — https://docs.algovoi.co.uk/api-reference/errors
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/rate-limits/algovoi-co-uk-rate-limits.yml
- **RateLimits** — https://docs.algovoi.co.uk/api-reference/rate-limits
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/asyncapi/algovoi-co-uk-webhooks.yml
- **Webhooks** — https://docs.algovoi.co.uk/integrations/outbound-webhooks
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/sandbox/algovoi-co-uk-sandbox.yml
- **Plans** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/plans/algovoi-co-uk-plans-pricing.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/data-model/algovoi-co-uk-data-model.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/overlays/algovoi-co-uk-gateway-overlay.yaml
- **AgentCard** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/a2a/algovoi-co-uk-a2a.yml
- **AgentCard** — https://api.algovoi.co.uk/.well-known/agent-card.json
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/skills/algovoi-co-uk-algovoi.md
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/skills/algovoi-co-uk-hosted-checkout.md
- **SignUp** — https://dash.algovoi.co.uk/signup
- **Components** — https://raw.githubusercontent.com/api-evangelist/algovoi-co-uk/refs/heads/main/components/algovoi-co-uk-components.yml

## Other AlgoVoi APIs (5)

- [AlgoVoi Pay (Payable Core) API](https://apis.io/apis/algovoi-co-uk/algovoi-pay-payable-core-api/)
- [AlgoVoi RFC 9421 Clinic (Verifiable-Comms Agent) API](https://apis.io/apis/algovoi-co-uk/algovoi-rfc9421-clinic-api/)
- [AlgoVoi Agent Trust Bench API](https://apis.io/apis/algovoi-co-uk/algovoi-agent-trust-bench-api/)
- [AlgoVoi Audit Verifier API](https://apis.io/apis/algovoi-co-uk/algovoi-audit-verifier-api/)
- [AlgoVoi MCP Server](https://apis.io/apis/algovoi-co-uk/algovoi-mcp-server/)

## Tags

Payments, Agentic Commerce, x402, MPP, AP2, A2A, Compliance

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/algovoi-co-uk/algovoi-gateway-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/algovoi-co-uk/.