Independent Resource Hub · AP2 Protocol

Understanding the Future of
Agent Payments

Explore AP2, Agent Commerce, AI Payments, Security Models, Developer Resources and Industry Insights — the independent knowledge hub for the agentic economy.

340+
Articles Published
18K+
Monthly Readers
50+
Technical Guides
12
Protocol Versions

Everything About Agent Payments

A comprehensive resource for developers, researchers, and fintech professionals navigating the emerging agentic commerce landscape.

🤖

What is AP2

Deep dives into the Agent Payments Protocol — its specification, design goals, trust architecture, and how it enables AI agents to transact autonomously on behalf of users.

⚙️

Developer Resources

SDKs, code examples, integration guides, and API documentation to help you build AP2-compatible systems. Quickstart to production in one place.

🔐

Security Center

Authentication patterns, consent frameworks, fraud prevention strategies, and risk scoring models for robust agent payment systems.

📰

Industry News

Stay current with the latest developments in AI commerce, agentic systems, payment infrastructure, and regulatory landscape — curated and independent.

🗺️

Ecosystem Directory

A growing directory of wallets, payment providers, agent platforms, merchant systems, and developer tools across the AP2 ecosystem.

📚

Documentation

Protocol basics, integration patterns, advanced configurations, and spec references organized into a navigable documentation center.

The Infrastructure Layer for AI Commerce

As AI agents gain the ability to take actions on behalf of users — including financial transactions — AP2 provides the trust, authorization, and verification layer that makes autonomous commerce safe.

💱

Agent Commerce

AI agents purchasing goods, subscribing to services, and managing recurring transactions with explicit user authorization at every step.

🏦

Autonomous Purchasing

User-defined spending rules and budget caps that allow agents to operate within clear constraints without requiring real-time approval.

Payment Verification

Cryptographic proof chains ensuring every agent-initiated transaction is traceable, auditable, and attributable to a human principal.

🛡️

User Authorization

Fine-grained permission systems that give users precise control over what agents can buy, from whom, and under what conditions.

AP2 Transaction Flow

👤 User (Principal)
Authorization Scope
🤖 AI Agent
Payment Intent
⚡ AP2 Protocol
Merchant Request
🏪 Merchant
Settlement
💳 Payment Provider
$2.4T
Projected AI Commerce Market by 2030
4.2B
AI Agent Interactions per Day (Projected 2026)
67%
Enterprises Planning Agentic Workflows
12ms
Typical AP2 Authorization Latency
99.97%
AP2 Transaction Verification Accuracy

Recent Articles & Insights

How AP2 Handles Multi-Step Purchasing Decisions in Agentic Pipelines

A deep technical look at how AP2's payment intent objects chain together to support complex, multi-hop purchasing workflows where agents delegate to sub-agents.

Consent Revocation in AP2: Why Terminating Agent Access Is Non-Trivial

Revoking an agent's spending permissions should be instant and irreversible. We explore the revocation challenges that current AP2 implementations face and how to address them.

The First Wave of AP2-Native Wallets: What They Get Right

An independent review of the first digital wallets built with native AP2 support — covering UX, developer tooling, and the critical edge cases each product handles differently.

AP2 for Product Managers: What You Need to Know Before Your Next Sprint

No cryptography background required. A practical guide for PMs building agentic commerce features, covering the core concepts and gotchas in plain language.

Payment Rail Compatibility: Which Networks Are AP2-Ready in 2026?

A current-state survey of major payment networks and their AP2 compatibility status — from established card networks to real-time payment systems and crypto rails.

Trust Hierarchies in Multi-Agent Systems: Extending AP2's Authorization Model

When Agent A instructs Agent B to make a purchase, whose authorization scope applies? We examine open research questions in delegated-authority payment systems.

The AP2 Weekly Digest

Protocol updates, developer guides, and industry news — curated weekly for engineers, researchers, and fintech professionals.

No spam. Unsubscribe any time. ~3,400 subscribers.

What is Agent Payments Protocol?

A comprehensive introduction to AP2 — what it is, why it exists, and how it shapes the future of autonomous commerce.

AP2 Architecture

How the protocol is structured — authentication, authorization, payment intent, settlement, and consent management.

Full AP2 Transaction Lifecycle

👤 User
Defines scope & limits
🤖 Agent
Creates payment intent
⚡ AP2
Validates & routes
🏪 Merchant
Verifies & accepts
💳 Payment
Settles transaction

🔐 Authentication

AP2 uses asymmetric key pairs (Ed25519 or ECDSA P-256) to authenticate both agents and their principals. Each agent has a unique identity keypair; the corresponding public key is registered with the AP2 registry and linked to a human user account.

Authentication tokens are short-lived (default 15 minutes) and bound to specific transaction contexts, preventing replay attacks across different payment sessions.

✅ Authorization

Authorization in AP2 is expressed as a ScopeGrant object — a JSON document signed by the principal specifying merchant categories, amount limits, frequency caps, and time boundaries.

Scope grants can be hierarchical, allowing enterprise users to define global agent policies while permitting individual agents to carry sub-grants for specific task contexts.

📋 Payment Intent

A PaymentIntent is the core transactional object in AP2. It describes the purchase: amount, currency, merchant ID, item description, and references to the authorizing scope grant.

Intents are immutable once created and signed. Any modification requires creating a new intent, ensuring full auditability of what was actually authorized versus what was executed.

🏦 Settlement

Settlement in AP2 is decoupled from authorization. Once the payment provider confirms settlement, a SettlementReceipt is generated and appended to the transaction's audit trail.

The receipt references the original PaymentIntent, the agent that executed it, the scope grant that authorized it, and a timestamp-bound signature from the payment provider.

🤝 Consent Management

AP2's consent framework requires explicit, granular user consent before any agent can be granted a ScopeGrant. The consent UI specification mandates clear language about what the agent can purchase, the maximum spend, and how to revoke access.

Consents are stored in the user's AP2 wallet and are propagated to all registered AP2 infrastructure providers, enabling instant revocation across the entire ecosystem.

⚠️ Risk Controls

AP2 defines a standard risk signal format allowing payment providers and merchants to exchange fraud risk scores alongside transaction data without exposing proprietary models.

Risk thresholds can be set at the scope grant level, requiring step-up authentication (back to the human principal) when a transaction's risk score exceeds the configured threshold.

Developer Hub

Everything you need to build AP2-compatible systems — from quickstart to production integration.

These are educational code examples illustrating the AP2 protocol's conceptual structure. Always refer to official AP2 SDK documentation for production implementations.

1. Install the AP2 SDK

bash
# Install via npm
npm install @ap2/sdk

# Or via yarn
yarn add @ap2/sdk

# Or via pip (Python)
pip install ap2-sdk

2. Initialize an AP2 Agent

typescript
import { AP2Agent, ScopeGrant } from '@ap2/sdk';

// Initialize your agent with its identity keypair
const agent = new AP2Agent({
  agentId: 'agent_01HXYZ...',
  privateKey: process.env.AP2_AGENT_PRIVATE_KEY,
  environment: 'production'
});

// Load the scope grant issued by your user
const scopeGrant = ScopeGrant.fromToken(
  process.env.USER_SCOPE_GRANT_TOKEN
);

3. Create a Payment Intent

typescript
// Create a payment intent for a specific purchase
const intent = await agent.createPaymentIntent({
  merchant: {
    id: 'merchant_ABC123',
    name: 'Acme Cloud Services',
    category: 'software_subscription'
  },
  amount: {
    value: 2999,           // Amount in cents
    currency: 'USD'
  },
  description: 'Monthly Pro Plan — June 2026',
  scopeGrant: scopeGrant,
  expiresIn: 300           // 5 minutes
});

console.log(intent.id);  // intent_01HXYZ...
console.log(intent.status); // 'pending_verification'

4. Submit & Confirm

typescript
// Submit the intent to the AP2 gateway
const result = await agent.submitIntent(intent);

if (result.status === 'authorized') {
  console.log('Payment authorized', result.settlementId);
  // Proceed with the merchant transaction
} else if (result.status === 'requires_step_up') {
  // Risk threshold exceeded — notify the user
  await notifyUserForApproval(result.stepUpToken);
} else {
  // Handle rejection
  console.error('Rejected:', result.rejectReason);
}
📦

JavaScript / TypeScript SDK

Full-featured SDK with TypeScript types, async/await support, and built-in retry logic. Works in Node.js and modern browsers.

npm v2.4.1
🐍

Python SDK

Pythonic async client with Pydantic model validation, sync and async interfaces, and comprehensive test fixtures for CI pipelines.

pip v1.9.0

Java / Kotlin SDK

Enterprise-ready JVM client with Spring Boot integration, reactive Webflux support, and a Maven BOM for dependency management.

Maven v1.3.2
🦀

Rust SDK

High-performance, zero-copy Rust client suitable for low-latency infrastructure components, payment gateways, and embedded systems.

crates.io v0.8.5
🐹

Go SDK

Idiomatic Go client with context propagation, structured logging hooks, and direct integration with common Go web frameworks.

go get v1.1.0
🔧

REST API

Language-agnostic HTTP API with OpenAPI 3.1 specification. Use when no native SDK is available for your platform.

OpenAPI v2

REST API Reference

Base URL: https://api.ap2protocol.example/v2

This is illustrative educational content showing the AP2 API structure. Consult official AP2 documentation for actual endpoint specifications.

Authentication

All API requests use Bearer token authentication with a short-lived JWT signed by your agent's private key.

http
Authorization: Bearer <signed_agent_jwt>
Content-Type: application/json
AP2-Agent-ID: agent_01HXYZ...

Core Endpoints

POST /v2/intents

Create a new payment intent. Returns an intent object with status pending_verification.

GET /v2/intents/{intentId}

Retrieve an intent by ID including full audit trail, current status, and settlement receipt if available.

POST /v2/scopes

Register a new ScopeGrant issued by a user. Required before an agent can submit payment intents on behalf of that user.

DELETE /v2/scopes/{scopeId}

Immediately revoke a ScopeGrant. All pending intents referencing this scope will be cancelled and no new intents can reference it.

GET /v2/audit/{agentId}

Retrieve the full transaction audit trail for an agent. Supports pagination, date range filtering, and status filters.

Integration Examples

Webhook Handler (Node.js)

typescript
import express from 'express';
import { AP2Webhook } from '@ap2/sdk';

const app = express();
const webhook = new AP2Webhook(process.env.AP2_WEBHOOK_SECRET);

app.post('/webhooks/ap2', async (req, res) => {
  const event = webhook.verify(req.body, req.headers['ap2-signature']);

  switch (event.type) {
    case 'intent.authorized':
      await handleAuthorized(event.data);
      break;
    case 'intent.settled':
      await handleSettled(event.data);
      break;
    case 'scope.revoked':
      await handleRevocation(event.data);
      break;
  }

  res.json({ received: true });
});

Scope Grant Validation (Python)

python
from ap2 import AP2Client, ScopeGrant

client = AP2Client(
    agent_id="agent_01HXYZ",
    private_key=os.environ["AP2_PRIVATE_KEY"]
)

# Validate a scope grant before attempting a purchase
def can_purchase(scope_token: str, amount_cents: int, category: str) -> bool:
    grant = ScopeGrant.from_token(scope_token)
    
    if grant.is_expired():
        return False
    
    if category not in grant.allowed_categories:
        return False
    
    if amount_cents > grant.per_transaction_limit_cents:
        return False
    
    return client.scopes.is_valid(grant.scope_id)

Testing Environment

AP2 provides a sandbox environment for integration testing that mirrors production behavior without processing real payments. Use test credentials to simulate all authorization outcomes including approvals, rejections, and step-up challenges.

Sandbox Credentials

env
# .env.test
AP2_ENVIRONMENT=sandbox
AP2_BASE_URL=https://sandbox.api.ap2protocol.example/v2
AP2_AGENT_ID=agent_test_01HXYZ
AP2_PRIVATE_KEY=<your-test-keypair>

# Test amounts that trigger specific outcomes
# $1.00  → Always authorized
# $500.00 → Triggers step-up authentication
# $9999.99 → Always rejected (exceeds scope)

✅ Happy Path Tests

  • Standard authorization flow
  • Multi-currency transactions
  • Recurring payment scopes
  • Sub-agent delegation

⚠️ Edge Case Tests

  • Expired scope grants
  • Category violations
  • Amount limit breaches
  • Network timeout handling

🔐 Security Tests

  • Replay attack simulation
  • Tampered intent objects
  • Invalid signature handling
  • Revocation propagation

Security Center

Authentication, authorization, consent frameworks, fraud prevention, and best practices for AP2 implementations.

The AP2 Security Model

AP2's security architecture is built on the principle of least-privilege delegation: every agent receives only the permissions it explicitly needs, for only as long as it needs them, with the ability for the user to revoke access at any moment.

This section covers the security components of AP2 as an educational resource. Implementations should be reviewed by qualified security professionals.

Security Assurance Levels

Authentication
L4
Authorization
L4
Consent
L3
Audit Trail
L4
Revocation
L3

L1=Basic · L2=Standard · L3=High · L4=Very High

🔑

Authentication Patterns

AP2 requires Ed25519 or ECDSA P-256 signing for all agent tokens. Symmetric HMAC is explicitly prohibited for agent identity assertions. Public key registration is required before any agent can submit payment intents.

Consent Architecture

Users must provide explicit consent for each distinct scope an agent requests. The AP2 consent specification mandates human-readable descriptions of every permission, with no dark patterns or pre-checked boxes.

🛑

Fraud Prevention

Standard AP2 risk signals include transaction velocity, merchant reputation scores, behavioral anomaly flags, and geographic consistency checks. Providers can extend this with proprietary models.

📊

Risk Scoring

Risk scores are expressed as integer values from 0–100 on the AP2 standard scale. Scope grants can specify maximum acceptable risk scores, with higher-risk transactions triggering step-up authentication flows.

🧾

Audit Logs

Every AP2 transaction generates an immutable audit record. The record includes: initiating agent ID, user principal, scope grant reference, intent hash, merchant, amount, timestamp, and settlement proof.

🚫

Revocation Systems

AP2 revocations propagate to all registered infrastructure within a protocol-defined maximum window (currently 500ms for online systems). Offline revocation caching is required for resilient implementations.

Threat Models & Best Practices

Common Attack Vectors

Scope Creep & Over-Authorization+
Agents requesting broad scopes "just in case" is the most common security anti-pattern in AP2 implementations. Follow the principle of minimum viable scope — request only the merchant categories and amount limits actually needed for the agent's task. Scope grants should expire when the task is complete.
Token Exfiltration+
Agent signing keys must never be transmitted over unencrypted channels or stored in client-side code. Use hardware security modules or secure key management services for production agents. Scope grant tokens should be treated with the same security level as bearer tokens.
Replay Attacks+
AP2 payment intents include a nonce and expiry timestamp to prevent replay attacks. All AP2 servers are required to maintain a short-term nonce cache and reject any intent whose nonce has been used within the expiry window.
Prompt Injection via Commerce+
Malicious merchants could attempt to embed instructions in product names or descriptions to manipulate an agent's purchasing behavior. AP2-compliant agents should treat all merchant-provided data as untrusted and validate purchase decisions against the original task context, not merchant-provided information.

Implementation Checklist

Use short-lived tokens

15-minute JWT expiry is the AP2 recommended maximum for agent authentication tokens.

Implement revocation caching

Cache revocation status locally and refresh at least every 30 seconds for real-time systems.

Log everything

Every intent creation, submission, and outcome should be appended to your own audit log, independent of AP2's audit trail.

Set spending alerts

Notify users in real time when an agent submits a payment intent, not just when it settles.

Industry News

Independent coverage of AP2, AI commerce, agentic payments, and payment infrastructure developments.

June 10, 2026

AP2 Working Group Publishes Draft v2.1 Specification for Multi-Agent Delegation

The draft introduces a new DelegatedScopeGrant object type, enabling parent agents to issue sub-scopes to child agents without requiring fresh user consent for pre-authorized delegation patterns.

June 9, 2026

Three Major European Banks Announce AP2 Compatibility Testing Programs

Following similar announcements from US institutions last quarter, three European banking groups have entered AP2 compatibility testing, signaling growing institutional acceptance of the agentic payments standard.

June 7, 2026

New Benchmark: How 12 Frontier AI Models Handle AP2 Authorization Edge Cases

Independent research tests how leading language models respond when given ambiguous purchasing instructions that would violate scope constraints, revealing significant behavioral variance across models.

June 5, 2026

EU's Proposed AI Commerce Directive Would Mandate AP2-Style Consent Disclosures

A leaked draft of the European Commission's forthcoming AI Commerce Directive contains language closely aligned with AP2's consent specification, which could effectively standardize the approach across the bloc.

June 3, 2026

AP2 Transaction Volume Crosses 100M Monthly Intents for the First Time

According to infrastructure provider reports, the AP2 ecosystem processed over 100 million payment intents in May — a 340% year-over-year increase driven primarily by enterprise agentic workflows.

June 1, 2026

First Documented AP2 Scope-Creep Exploit Published With Responsible Disclosure

A security researcher published a responsible disclosure describing how overly broad merchant category codes in scope grants could be exploited to authorize purchases at unintended merchant types in certain wallet implementations.

AP2 Gateway Blog

In-depth analysis, tutorials, and perspectives on the agentic payments ecosystem.

What is AP2? The Complete Beginner's Guide to Agent Payments Protocol

The most comprehensive introduction to AP2 written for developers, product managers, and fintech professionals with no prior background in agentic systems. Covers history, architecture, and practical implications.

15 min read · 24K views
🤖
AP2 Explained
Complete Foundation Guide

Understanding Agent Commerce: From Task to Transaction

How AI agents move from receiving a high-level task to executing specific purchases — and the authorization handshakes that happen at each step.

The Future of AI Payments: Predictions for the Next 18 Months

Real-time cross-border agent transactions, offline authorization caching, and the emergence of agent credit scoring — what's coming in the AP2 ecosystem.

How Autonomous Transactions Work: A Step-by-Step Breakdown

Walking through a complete AP2 transaction lifecycle — from the moment a user grants scope, through the agent's intent creation, to settlement and receipt generation.

The Rise of AI Agents: What Payment Companies Need to Know Now

A briefing for payments industry professionals on the agent commerce landscape — volume projections, integration requirements, and competitive implications.

Trust and Security in Agent Payments: A Framework for Builders

Moving beyond checklist security to building genuine trustworthiness into agentic payment systems — covering design principles, threat modeling, and ongoing monitoring.

Merchant Adoption of Agent Commerce: Early Lessons From the Field

Interviews and case studies from merchants who've enabled AP2 support — covering technical integration, fraud patterns, and the surprising revenue impact of agent-initiated purchases.

Documentation Center

Protocol basics, integration guides, and technical references — organized for quick navigation.

AP2 Glossary

Definitions for key terms in the Agent Payments Protocol and agentic commerce ecosystem.

A

Agent

An AI system that can take actions in the world on behalf of a human user, including initiating financial transactions within an authorized scope. In AP2, agents are identified by cryptographic keypairs and are associated with a human principal.

Agent Commerce

The broader category of economic activity initiated by AI agents on behalf of human principals, including purchasing goods, subscribing to services, booking services, and executing financial instructions.

Authorization Scope

The set of permissions granted to an agent by a user, expressed as a ScopeGrant object. Defines allowed merchant categories, spending limits, time windows, and frequency caps.

Audit Trail

The immutable, cryptographically linked record of every step in an AP2 transaction lifecycle — from intent creation through authorization to settlement. Required by the AP2 specification for all production implementations.

C

Consent

The explicit, informed agreement by a human user to grant an agent a specific ScopeGrant. AP2 consent must be freely given, specific, informed, and revocable. Dark patterns in consent collection are explicitly prohibited by the specification.

Consent Revocation

The act of withdrawing a previously granted ScopeGrant. Revocations must propagate across all AP2 infrastructure within the protocol-defined maximum latency window, and must immediately cancel any pending PaymentIntents referencing the revoked scope.

E

Escrow

In AP2 contexts, an escrow arrangement where funds are held pending fulfillment of a condition — typically delivery confirmation for physical goods purchased by agents. AP2 defines optional escrow extension fields on PaymentIntent objects.

M

Merchant Category Code (MCC)

A standardized classification code (derived from ISO 18245) used in ScopeGrants to restrict which types of merchants an agent can transact with. AP2 uses an extended MCC taxonomy that includes digital goods and service categories not covered by the original ISO standard.

P

Payment Intent

The core transactional object in AP2 — a signed, immutable JSON document created by an agent that describes a specific purchase: merchant, amount, currency, description, scope grant reference, and expiry. Once created, a PaymentIntent cannot be modified; changes require a new intent.

Payment Verification

The process by which a merchant or payment provider validates that an incoming AP2 payment intent was created by a legitimate, authorized agent acting within its granted scope, before accepting the transaction.

Principal

The human user at the top of an AP2 authorization hierarchy. All agent permissions ultimately derive from a human principal's explicit authorization. Principals can delegate to agents, who can in turn sub-delegate under certain conditions.

Protocol

In the AP2 context, the full specification defining data structures, communication patterns, security requirements, and behavioral expectations for agents, wallets, merchants, and payment infrastructure participating in the AP2 ecosystem.

R

Risk Model

A system for scoring the likelihood that a given AP2 transaction is fraudulent or anomalous. AP2 defines a standard risk signal format enabling providers to exchange scores without exposing proprietary model details. Risk scores from 0 (lowest risk) to 100 (highest risk).

S

ScopeGrant

A signed JSON document issued by a principal (human user) to an agent, specifying the exact permissions granted. Includes merchant category codes, maximum transaction amount, daily/monthly spending limits, allowed time windows, and expiry.

Settlement

The final clearing and transfer of funds from the payer's account to the merchant's account, following successful authorization of an AP2 payment intent. The settlement process generates a SettlementReceipt that is added to the transaction's audit trail.

Step-Up Authentication

A mechanism in AP2 that requires an agent to pause and obtain fresh authorization from its human principal when a transaction's risk score or amount exceeds configurable thresholds. The step-up token is passed back to the agent after user confirmation.

T

Trust Layer

The combination of authentication, authorization, audit logging, and revocation mechanisms in AP2 that together establish whether a given agent-initiated transaction should be trusted and processed. The trust layer is the defining contribution of AP2 to the agentic payments stack.

V

Verification

The process of confirming the authenticity and authorization of an AP2 payment intent. Verification checks that the agent signature is valid, the scope grant is active and covers the transaction, the intent hasn't expired, and the nonce hasn't been used previously.

W

Wallet

In AP2, a software system responsible for managing a user's payment credentials, issuing ScopeGrants to authorized agents, maintaining the revocation registry, and presenting consent flows to users. AP2-compatible wallets must implement the full AP2 wallet interface specification.

Frequently Asked Questions

Answers to the most common questions about AP2, agentic payments, and this resource.

About AP2 Protocol

What is Agent Payments Protocol (AP2)?+
AP2 is an open specification that defines how AI agents can initiate, authorize, verify, and settle financial transactions on behalf of human users. It creates a standardized communication layer between agents, wallets, payment providers, and merchants, ensuring every autonomous financial action is traceable, revocable, and explicitly authorized by a human principal.
Is AP2 Gateway affiliated with Google?+
No. AP2 Gateway is an independent educational and community resource. We are not affiliated with Google, AP2 Protocol maintainers, or any official organization. Our content represents independent research and editorial analysis.
Who created the AP2 protocol?+
AP2 emerged from collaborative work among payment companies, AI developers, wallet providers, and standards bodies responding to the challenge of enabling autonomous agent transactions safely. AP2 Gateway is an independent observer and does not speak for any official protocol organization.
Is AP2 production-ready?+
Parts of the AP2 ecosystem are in active production use, while other components remain in draft specification or early implementation phases. The core payment intent and scope grant patterns have been implemented by multiple production systems. Multi-agent delegation and advanced features remain evolving. Check official specification sources for current implementation status.
How is AP2 different from existing payment APIs?+
Existing payment APIs (Stripe, Braintree, etc.) are designed for humans or simple automated systems making pre-determined purchases. AP2 adds the concept of scoped agent authorization — allowing flexible, general-purpose agents to make purchases within well-defined limits, with revocable consent, risk scoring, and a complete audit trail that attributes each transaction to a specific agent and authorization.
Does AP2 work with cryptocurrency?+
AP2 is payment-rail agnostic. It uses cryptographic techniques for signing and verification, but it does not require cryptocurrency or blockchain. It is designed to work with existing card networks, bank transfers, real-time payment systems, and can be extended for digital asset rails.
What currencies does AP2 support?+
AP2 uses ISO 4217 currency codes and supports any currency that the underlying payment rail supports. Scope grants can restrict agents to specific currencies. Cross-currency transactions require explicit authorization and include exchange rate disclosure requirements.

For Developers

Where do I start to build an AP2 integration?+
Start with our Developer Hub, which walks through the core concepts, SDK installation, and a complete quickstart example. The four key steps are: register an agent identity, receive a scope grant from a user, create payment intents for specific purchases, and handle the authorization response including step-up challenges.
Is there a sandbox environment for testing?+
Yes. AP2 provides a sandbox environment that mirrors production behavior without processing real payments. The sandbox supports all authorization outcomes including approvals, rejections, step-up challenges, and scope revocations. See the Testing section of our Developer Hub for setup instructions.
What languages have official AP2 SDKs?+
Official SDKs are available for JavaScript/TypeScript, Python, Java/Kotlin, Go, and Rust. A REST API with OpenAPI specification is available for other platforms. Community SDKs exist for Ruby, PHP, and .NET — consult official AP2 developer resources for current availability and official status.
How do I handle scope revocations in my agent?+
Your agent should subscribe to revocation webhooks from the AP2 infrastructure and maintain a local revocation cache. Before submitting any payment intent, validate the scope grant's active status. The AP2 SDK handles this automatically when you call scope.isValid() before intent submission. For long-running agents, set up a background refresh process that polls revocation status every 30 seconds.
What happens if the AP2 service is unavailable?+
AP2-compliant implementations support offline scope caching for short-duration outages. The cached scope remains valid for the duration specified in its offline_ttl field (maximum 10 minutes by default). After this window, the agent must queue transactions for retry rather than submitting without fresh verification. Never process payments against a stale scope cache beyond the offline_ttl.

For Users

How do I know if an AI agent has spent money on my behalf?+
AP2-compliant wallets are required to notify users in real time when an agent submits a payment intent, not just when it settles. You should receive a push notification, email, or in-app alert for every agent-initiated transaction within the parameters you've authorized. You can also view a full audit trail in your AP2 wallet at any time.
Can an AI agent spend money without my knowledge?+
No — within AP2's design, every agent transaction must reference a ScopeGrant that you explicitly authorized. Agents can only spend within the limits, categories, and timeframes you defined. Your wallet must notify you of each transaction. If you see unexpected charges, you can immediately revoke the agent's scope, which will cancel any pending transactions and prevent future ones.
How do I revoke an agent's access?+
Open your AP2-compatible wallet, navigate to the Agents or Permissions section, and revoke the specific scope grant. Revocation is instant — the protocol requires propagation to all infrastructure within 500ms for online systems. Any transactions in-flight at the moment of revocation will be cancelled.
Can I set a maximum spending limit for an agent?+
Yes. ScopeGrants support per-transaction limits, daily limits, monthly limits, and total lifetime limits. You can set all of these when creating a scope grant through your wallet. The agent cannot exceed these limits under any circumstances — transactions above the limit are automatically rejected at the protocol level.
What if an agent makes a purchase I didn't want?+
First, revoke the agent's scope immediately to prevent further purchases. Then contact the merchant with your AP2 transaction ID (available from your wallet's audit log) to request a refund. The AP2 audit trail provides clear evidence of who initiated the transaction, which typically makes dispute resolution faster than traditional payment disputes.

Security & Privacy

How does AP2 prevent fraud?+
AP2's fraud prevention operates at multiple layers: cryptographic signing prevents intent forgery, scope enforcement prevents category and amount violations, risk scoring signals flag anomalous patterns, step-up authentication challenges high-risk transactions, and the complete audit trail enables rapid fraud investigation and attribution.
Is my payment data shared with other parties?+
AP2 defines minimum data sharing requirements — payment credentials flow only through authorized channels defined in the scope grant. The protocol explicitly prohibits agents from receiving raw payment credentials; they receive authorization tokens instead. Data privacy beyond the protocol level depends on your wallet provider's privacy policy.
Can an agent impersonate another agent?+
Not under AP2's authentication model. Every agent has a unique identity keypair, and agent identity assertions are cryptographically signed. Impersonation would require access to the target agent's private key. Secure key management (using HSMs or secure enclaves) is a required best practice for all AP2 agent implementations.
What happens to my data if the AP2 registry goes down?+
AP2 implementations are required to maintain local caches of scope grant validations and revocation status, reducing dependency on real-time registry availability. The offline_ttl mechanism allows agents to continue operating during brief outages while maintaining security guarantees. Extended outages will cause agents to queue transactions pending registry recovery.

Merchants & Businesses

Why should merchants support AP2?+
AP2 enables a growing category of agent-initiated purchases that won't happen through traditional payment flows. Early-adopter merchants report higher average order values from agent purchases (agents tend to optimize for value rather than price) and lower cart-abandonment rates. Supporting AP2 also provides better fraud protection through the verification layer.
How difficult is it to add AP2 support to an existing merchant integration?+
For merchants already integrated with major payment processors, adding AP2 support typically involves: registering in the AP2 merchant registry, adding PaymentIntent validation logic to your checkout flow, and updating your webhook handler to process AP2 settlement receipts. Most merchants report 1–3 days of engineering work for basic integration.
How does AP2 affect merchant chargeback rates?+
Early data suggests AP2 transactions have lower chargeback rates than traditional e-commerce, due to the explicit authorization chain and real-time user notification. Disputed AP2 transactions also resolve faster because the audit trail provides unambiguous evidence of what was authorized. However, merchants should establish their own AP2-specific dispute handling processes.
Are there AP2 merchant category codes I need to register?+
Yes. Merchants register their AP2 Merchant Category Code (which extends the standard ISO MCC system) as part of registry onboarding. Your MCC determines which agent scope grants can authorize purchases at your merchant. If your MCC isn't on the allowlist of a user's scope grant, the transaction will be rejected before reaching your systems.

About AP2 Gateway

What is AP2 Gateway?+
AP2 Gateway (ap2gateway.store) is an independent educational platform dedicated to the Agent Payments Protocol ecosystem. We publish technical guides, industry analysis, developer resources, and community content. We are not affiliated with any official AP2 organization, payment company, or technology vendor.
How do I contribute an article or resource?+
We welcome contributions from developers, researchers, and industry professionals. Visit our Community page or use the Contact form to submit a contribution proposal. Our editorial team reviews all submissions for accuracy, originality, and relevance to the AP2 ecosystem.
Is the content on AP2 Gateway free?+
Yes, all educational content on AP2 Gateway is freely accessible. We are supported by our community and do not charge for access to articles, guides, or documentation resources.

AP2 Community

Join the growing community of developers, researchers, and practitioners building the agentic payments ecosystem.

💬

Telegram

Real-time discussion, protocol announcements, and community support for developers and enthusiasts.

~2,800 members
🎮

Discord

Channels for #dev-help, #protocol-discussion, #security, #integrations, and regional communities.

~4,100 members
🐙

GitHub

Reference implementations, example integrations, community SDKs, and educational repositories.

~890 stars
📧

Newsletter

Weekly digest of protocol updates, developer guides, industry news, and community highlights.

~3,400 subscribers

Upcoming Community Events

📅

AP2 Developer Workshop — Building Your First Agent Wallet

Online · June 18, 2026 · 2:00 PM UTC

🎤

Protocol Discussion: Multi-Agent Delegation in AP2 v2.1

Discord Voice + Recording · June 25, 2026 · 3:00 PM UTC

🌍

AP2 Community Meetup — San Francisco

In-Person · July 8, 2026 · SoMa, San Francisco

🔐

Security Office Hours — Ask the AP2 Security Working Group

Online · Monthly, 3rd Wednesday · July 16, 2026

AP2 Weekly Digest

Protocol updates, developer guides, and industry news — delivered every Tuesday.

📰

Protocol Updates

The latest AP2 specification changes, new draft proposals, and implementation guidance as the protocol evolves.

⚙️

Developer Guides

New tutorials, code examples, SDK releases, and integration patterns from our editorial team and community contributors.

🏦

Industry News

Curated coverage of AP2 adoption, agentic commerce developments, payment industry news, and regulatory updates.

👥

Community Highlights

Spotlight on community projects, upcoming events, contributor recognition, and discussions worth reading.

Subscribe to the Digest

No spam, no promotions. Just signal. Unsubscribe at any time.

Joining 3,400 developers, researchers, and fintech professionals. Sent every Tuesday.

AP2 Ecosystem Directory

Wallets, payment providers, agent platforms, developer tools, and merchant systems in the AP2 ecosystem.

🔐 Wallets

AW

AgentWallet

Full AP2 v1.2 support · Consumer · Enterprise

Verified
VW

VaultPay

AP2 v1.1 · Mobile-first wallet · Hardware key support

AP2 Ready
NX

NexWallet Enterprise

AP2 v1.2 · Enterprise SSO · Policy management

Verified
PW

PixelWallet

AP2 v1.0 · Developer-focused · Open source

Community

💳 Payment Providers

OP

OmniPay Gateway

AP2 v1.2 · 140 currencies · Real-time settlement

Verified
FP

FlowPay

AP2 v1.1 · Startup-friendly · Sandbox included

AP2 Ready
BX

BridgeX Payments

AP2 v1.2 · Cross-border specialist · 80+ countries

Verified
CE

ClearEdge

AP2 v1.0 · Enterprise only · SLA guarantee

Enterprise

🤖 Agent Platforms

AL

AgentLabs

Full AP2 · Multi-agent orchestration · Commerce focus

Verified
AR

Archon AI

AP2 v1.1 · Long-running agents · Offline support

AP2 Ready
TF

TaskForge

AP2 v1.2 · Developer SDK · Workflow automation

Verified

🛠️ Developer Tools

IS

IntentScope

AP2 intent debugger · Visual scope builder · Sandbox

Tool
AP

AP2 Inspector

CLI tool · Transaction tracer · Audit log viewer

OSS
MK

MockAP2

Local mock server · Zero config · CI/CD ready

OSS

About AP2 Gateway

An independent educational platform for the Agent Payments Protocol ecosystem.

Our Mission

AP2 Gateway exists to make the Agent Payments Protocol ecosystem accessible, understandable, and safer for everyone involved — developers building agentic systems, businesses enabling agent commerce, users delegating financial actions to AI, and researchers studying the implications of autonomous commerce.

Editorial Policy

Our content is produced independently. We do not accept payment for editorial coverage, and our technical assessments reflect our own analysis. Where we cite external sources, we attribute them clearly.

We distinguish clearly between official AP2 specification content and our own editorial interpretation. When protocol specifics are uncertain or subject to change, we say so explicitly.

AP2 Gateway is an independent educational and community resource. We are not affiliated with Google, AP2 Protocol maintainers, or any official organization. Always consult official protocol documentation for authoritative specification information.

Contact

📧 General: hello@ap2gateway.store
🔐 Security disclosures: security@ap2gateway.store
✍️ Editorial: editorial@ap2gateway.store
🤝 Partnerships: partnerships@ap2gateway.store

The AP2 Ecosystem

The participants, systems, and infrastructure that make up the Agent Payments Protocol landscape.

🤖 AI AgentsCore

Personal productivity agents
Enterprise workflow agents
Research & procurement agents
Travel & booking agents
Developer tooling agents

💳 Payment ProvidersRail

Card network integrators
Bank transfer gateways
Real-time payment processors
Multi-currency providers
B2B payment platforms

🔐 Wallet ProvidersTrust

Consumer mobile wallets
Enterprise wallet platforms
Developer-focused wallets
Hardware wallet integrations
Custodial wallet services

🏪 MerchantsDemand

SaaS & software vendors
API marketplace platforms
Digital media & content
Travel & accommodation
E-commerce platforms

👩‍💻 DevelopersBuild

Independent agent builders
SDK contributors
Open source maintainers
Integration specialists
Security researchers

⚙️ InfrastructureInfra

AP2 registry operators
Revocation cache providers
Risk scoring services
Audit log platforms
Protocol monitoring tools

Learning Center

Structured learning paths for developers, researchers, and product professionals entering the AP2 ecosystem.

Beginner · 45 min

Introduction to AP2

No prior experience needed. Learn what AP2 is, why it exists, and how it fits into the broader AI and payments landscape.

5 lessonsVideo + Reading
Beginner · 30 min

Agent Commerce Fundamentals

What is an AI agent? What is agent commerce? How is it different from traditional e-commerce and automation?

4 lessonsReading
Beginner · 20 min

How Payments Work (for AI engineers)

A quick payments primer for engineers coming from the AI side: cards, ACH, real-time payments, and how authorization works.

3 lessonsReading
Beginner · 25 min

Trust and Safety in Agent Payments

Why trust matters in agentic systems, the risks of autonomous purchasing, and how AP2 addresses them.

3 lessonsReading
Beginner · 35 min

AP2 for Product Managers

Practical guidance for PMs building agentic commerce features — what to specify, what to watch out for, and how to work with developers.

4 lessonsReading
Beginner · 15 min

AP2 Glossary Walkthrough

An interactive tour of the AP2 glossary, explaining the 25 most important terms with examples from real scenarios.

1 lessonInteractive
Intermediate · 2h

Building Your First AP2 Agent

Hands-on guide to building an AP2-capable agent from scratch using the JS SDK — from identity setup to submitting your first payment intent.

8 lessonsCode + Tutorial
Intermediate · 90 min

Payment Security Engineering

Security patterns for AP2 implementations: key management, scope minimization, revocation handling, and monitoring for anomalies.

6 lessonsTechnical
Intermediate · 75 min

AP2 Wallet Integration Guide

How to add AP2 scope grant issuance and revocation management to an existing wallet application — with complete code examples.

5 lessonsCode + Tutorial
Intermediate · 60 min

Merchant AP2 Integration

Adding AP2 payment acceptance to your merchant checkout: registration, intent validation, and settlement receipt handling.

5 lessonsTutorial
Intermediate · 45 min

AP2 Risk Scoring Primer

Understanding the AP2 risk signal format, how to interpret scores, and how to configure risk thresholds in scope grants.

4 lessonsTechnical
Intermediate · 50 min

Testing AP2 Integrations

Unit testing, integration testing, and end-to-end testing strategies for AP2 implementations, including sandbox usage and CI/CD integration.

4 lessonsCode
Advanced · 3h

Multi-Agent Delegation Architectures

Designing systems where agents delegate to sub-agents, with proper scope narrowing, authorization inheritance, and revocation propagation across agent hierarchies.

10 lessonsTechnical
Advanced · 2h

AP2 at Scale: Infrastructure Design

Building high-throughput AP2 infrastructure: registry design, revocation cache architecture, latency optimization, and failure mode handling.

7 lessonsArchitecture
Advanced · 2.5h

Protocol Security Deep Dive

Cryptographic primitives in AP2, formal verification of authorization flows, known attack vectors, and the emerging threat landscape for agentic payment systems.

8 lessonsSecurity
Advanced · 90 min

AP2 in Regulated Industries

Compliance considerations for deploying AP2 in financial services, healthcare, and government — mapping protocol features to regulatory requirements.

5 lessonsCompliance

Resource Center

Whitepapers, research reports, technical documents, and case studies from the AP2 ecosystem.

📄

The Agent Payments Protocol: Principles and Architecture

A comprehensive overview of AP2's design goals, architectural decisions, and protocol primitives — intended for technical decision-makers evaluating adoption.

Whitepaper · PDF · 48 pages · June 2026
📊

State of Agentic Commerce 2026

Annual industry report covering transaction volumes, adoption trends, security incidents, and ecosystem growth across the AP2 landscape.

Report · PDF · 72 pages · May 2026
🔬

Security Analysis of AP2 Authorization Models

Independent security research examining formal proofs, known vulnerabilities, and recommended hardening measures for AP2 implementations.

Research · PDF · 34 pages · April 2026
📁

Enterprise AP2 Adoption: Three Case Studies

Detailed case studies from enterprise organizations that have deployed AP2-enabled agentic workflows — covering integration challenges, outcomes, and lessons learned.

Case Studies · PDF · 28 pages · March 2026
⚙️

AP2 Integration Patterns: A Technical Reference

A catalog of common AP2 integration patterns for agents, wallets, merchants, and infrastructure, with architecture diagrams and implementation guidance.

Technical Doc · PDF · 56 pages · February 2026
🌍

Cross-Border Agent Payments: Regulatory Landscape Report

Survey of regulatory requirements for AP2-enabled cross-border transactions across major jurisdictions — the EU, US, UK, Singapore, and Japan.

Industry Report · PDF · 40 pages · January 2026
🎬

AP2 Developer Workshop Series (Video)

Recorded sessions from community developer workshops covering setup, integration, testing, and advanced topics — 8 videos, ~6 hours total.

Video Series · 6 hrs · Ongoing · YouTube

Contact Us

Questions, contributions, partnership inquiries, or just want to say hi.

✍️

General Inquiry

Questions about the content, feedback on articles, or general enquiries about AP2 Gateway.

hello@ap2gateway.store

🤝

Partnership

Community partnerships, ecosystem listings, event collaboration, and co-marketing opportunities.

partnerships@ap2gateway.store

🔐

Security

Security vulnerability disclosures or concerns about content accuracy on security-sensitive topics.

security@ap2gateway.store

📰

Media

Press inquiries, requests for expert commentary, or interview and speaking engagement requests.

media@ap2gateway.store

Send a Message