AlgoVoi

AlgoVoi Ap2 API

The Ap2 API from AlgoVoi — 7 operation(s) for ap2.

Documentation GitHub OpenAPI

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

POST /v1/ap2/verify Verify a payer's AP2 mandate credential · AP2 mandate verification #

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.

AlgoVoi Ap2 API

Operations 7

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification