AlgoVoi Ap2 API
The Ap2 API from AlgoVoi — 7 operation(s) for ap2.
Operations 7
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“How do I check that an AP2 mandate a payer submitted carries a valid signed JWT?”
“Can I verify an AP2 mandate on behalf of a specific merchant?”
Tell an agent
Verify AP2 mandate {mandate}.
Check the AP2 mandate {mandate} is valid for merchant {merchant_id}.
POST
/ap2/intent
Open an AP2 shopping session with an IntentMandate · Submit an IntentMandate to open an AP2 shopping session
#
Ask an LLM
“How does an agent start an AP2 shopping session?”
“Is the user's SD-JWT authorization checked when the intent is submitted, or later at pay?”
Tell an agent
Submit IntentMandate {mandate} to open a shopping session.
Start an AP2 session with intent {mandate} and user authorization {user_authorization}.
POST
/ap2/cart
Submit a merchant-signed CartMandate · Submit a merchant-signed CartMandate, verified against an accepted IntentMandate
#
Ask an LLM
“How do I attach a merchant-signed cart to an accepted AP2 intent?”
“What is the CartMandate checked against when I submit it?”
Tell an agent
Submit CartMandate {mandate} against intent {intent_id}.
Attach the merchant-signed cart {mandate} to AP2 intent {intent_id}.
POST
/ap2/pay
Submit a PaymentMandate and get a crypto challenge · Submit PaymentMandate; verify user_authorization and return crypto challenge
#
Ask an LLM
“How do I pay for an AP2 cart once it is accepted?”
“What does the gateway return after it verifies the PaymentMandate, a crypto challenge?”
Tell an agent
Submit PaymentMandate {mandate} for cart {cart_id}.
Start payment on AP2 cart {cart_id} and return the crypto challenge.
POST
/ap2/confirm
Confirm an AP2 on-chain payment and get a JWT · Confirm on-chain transaction; gateway verifies via facilitator and issues JWT
#
Ask an LLM
“After the on-chain transfer, how do I get the AP2 access token?”
“Which network and transaction details are needed to confirm an AP2 payment?”
Tell an agent
Confirm AP2 payment {payment_id} with transaction {tx_id} on {network}.
Verify tx {tx_id} for payment {payment_id} and issue the JWT.
GET
/ap2/status/{cart_id}
Inspect an AP2 mandate chain by cart · Inspect AP2 mandate chain state by cart_id
#
Ask an LLM
“Where is my AP2 cart in the intent, cart, payment and confirm chain?”
“Can I see the mandate chain state for one cart?”
Tell an agent
Show the AP2 mandate chain state for cart {cart_id}.
Check how far cart {cart_id} has progressed through AP2.
GET
/ap2/extensions
List the AP2 extensions this gateway supports · List AP2 extensions supported by this gateway
#
Ask an LLM
“Which AP2 extensions and crypto payment methods does the gateway support?”
“What should my agent discover before building a CartMandate?”
Tell an agent
List the supported AP2 extensions.
Show which crypto rails are available as AP2 payment methods.
Documentation
Documentation
https://docs.algovoi.co.uk/algovoi-pay
APIReference
https://pay.algovoi.co.uk/docs
GettingStarted
https://docs.algovoi.co.uk/chain-agnostic-negotiation
Authentication
https://artifacts.apis.io/algovoi-co-uk/authentication/algovoi-co-uk-authentication.yml
RateLimits
https://artifacts.apis.io/algovoi-co-uk/rate-limits/algovoi-co-uk-rate-limits.yml
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://docs.algovoi.co.uk/api-reference/authentication
RateLimits
https://docs.algovoi.co.uk/api-reference/rate-limits
Documentation
https://agents.algovoi.co.uk/clinic/guide
Documentation
https://docs.algovoi.co.uk/rfc9421-verifier
APIReference
https://agents.algovoi.co.uk/docs
Documentation
https://docs.algovoi.co.uk/agent-trust-bench
Documentation
https://docs.algovoi.co.uk/audit-verifier
APIReference
https://verify.algovoi.co.uk/docs
Documentation
https://docs.algovoi.co.uk/integrations/mcp-server
Specifications
Other Resources
AgentCard
https://artifacts.apis.io/algovoi-co-uk/a2a/algovoi-co-uk-a2a.yml
AgentCard
https://pay.algovoi.co.uk/.well-known/agent-card.json
LLMsTxt
https://artifacts.apis.io/algovoi-co-uk/llms/algovoi-co-uk-pay-llms.txt
LLMsTxt
https://pay.algovoi.co.uk/llms.txt
Conventions
https://artifacts.apis.io/algovoi-co-uk/conventions/algovoi-co-uk-conventions.yml
Idempotency
https://artifacts.apis.io/algovoi-co-uk/conventions/algovoi-co-uk-conventions.yml
ErrorCatalog
https://artifacts.apis.io/algovoi-co-uk/errors/algovoi-co-uk-problem-types.yml
Plans
https://artifacts.apis.io/algovoi-co-uk/plans/algovoi-co-uk-plans-pricing.yml
Sandbox
https://artifacts.apis.io/algovoi-co-uk/sandbox/algovoi-co-uk-sandbox.yml
ErrorCodes
https://docs.algovoi.co.uk/api-reference/errors
Webhooks
https://artifacts.apis.io/algovoi-co-uk/asyncapi/algovoi-co-uk-webhooks.yml
Webhooks
https://docs.algovoi.co.uk/integrations/outbound-webhooks
DataModel
https://artifacts.apis.io/algovoi-co-uk/data-model/algovoi-co-uk-data-model.yml
AgentCard
https://api.algovoi.co.uk/.well-known/agent-card.json
SignUp
https://dash.algovoi.co.uk/signup
Components
https://artifacts.apis.io/algovoi-co-uk/components/algovoi-co-uk-components.yml
AgentCard
https://agents.algovoi.co.uk/.well-known/agent-card.json
LLMsTxt
https://artifacts.apis.io/algovoi-co-uk/llms/algovoi-co-uk-clinic-llms.txt
LLMsTxt
https://agents.algovoi.co.uk/llms.txt
Dashboard
https://agent-trust-bench.algovoi.co.uk/stats
SourceCode
https://github.com/chopmob-cloud/algovoi-audit-verifier
ToolCrosswalk
https://artifacts.apis.io/algovoi-co-uk/mcp/algovoi-co-uk-tool-crosswalk.yml
SourceCode
https://github.com/chopmob-cloud/AlgoVoi-MCP-Server
Packages
https://artifacts.apis.io/algovoi-co-uk/packages/algovoi-co-uk-packages.yml