# AsterPay

> Trust, discovery, and fiat settlement layer for AI agent payments. USDC in, EUR to bank via SEPA Instant.

## API Base URL

- Production: https://x402.asterpay.io
- Documentation: https://asterpay.io/docs
- Agent Card: https://asterpay.io/.well-known/agent.json

## Free Endpoints (no authentication)

- [Trust Score](https://x402.asterpay.io/v1/agent/trust-score/{address}): GET — KYA trust assessment (0-100) for any wallet
- [Verify Agent](https://x402.asterpay.io/v1/agent/verify/{address}): GET — Quick identity + sanctions check
- [Trust Tier](https://x402.asterpay.io/v1/agent/tier/{address}): GET — Tier classification (unknown/basic/verified/trusted/enterprise)
- [Batch Trust](https://x402.asterpay.io/v1/agent/trust-score/batch): POST — Batch trust check (up to 50 addresses)
- [Settlement Estimate](https://x402.asterpay.io/v1/settlement/estimate?amount={usdc}): GET — EUR conversion estimate with fees
- [KYA Framework](https://x402.asterpay.io/v1/agent/framework): GET — Full KYA framework documentation
- [Discovery](https://x402.asterpay.io/v1/agent/discovery): GET — Service capabilities and pricing
- [Market Data](https://x402.asterpay.io/v2/x402/market/rates): GET — Live EUR/USD exchange rates

## Merchant Payment Endpoint (MPE) — Discovery

- [Resolve Merchant](https://x402.asterpay.io/v1/mpe/merchants/resolve?business_id={id}&business_id_type=vat): GET — Find merchant bank details (IBAN, BIC) from company name/ID
- [Register Merchant](https://x402.asterpay.io/v1/mpe/merchants): POST — Register merchant with IBAN + VoP verification
- [Settle via MPE](https://x402.asterpay.io/v1/mpe/settle): POST — Full settlement: resolve → VoP → KYA → SEPA Instant

MPE solves "agent knows the company name but not where to pay." AsterPay finds verified bank details from 5 sources + Verification of Payee (PSD2).

## Paid Endpoints (x402 or MPP — pay USDC per call)

- [Deep Analysis](https://x402.asterpay.io/v1/agent/deep-analysis/{address}): GET — $0.01 — Comprehensive agent analysis
- [Crypto Prices](https://x402.asterpay.io/v2/x402/crypto/prices): GET — $0.001 — Live crypto prices
- [AI Sentiment](https://x402.asterpay.io/v2/x402/ai/sentiment): POST — $0.005 — Market sentiment analysis

Both x402 and MPP payment protocols accepted on every paid endpoint.

## Session Billing (bulk purchase)

- GET /v1/sessions/packages — List packages (50/$0.10, 250/$0.40, 1000/$1.00)
- POST /v1/sessions/activate — Activate session after payment
- Use X-Session-Token header for subsequent calls — no per-call payment

## Payment Protocols (dual support)

Every 402 response includes both protocol headers. Agents use whichever SDK they have:

- x402: PAYMENT-REQUIRED header → PAYMENT-SIGNATURE → npm install @x402/fetch
- MPP: WWW-Authenticate: Payment header → Authorization: Payment → npm install mppx

## Settlement Flow

1. Agent calls GET /v1/settlement/estimate?amount=100 (free)
2. Agent checks trust: GET /v1/agent/trust-score/{address} (free)
3. Agent pays via x402 or MPP: USDC on Base
4. AsterPay converts USDC → EUR and sends via SEPA Instant (<5 seconds)

## Integration

- x402 SDK: npm install @x402/fetch | pip install x402
- MPP SDK: npm install mppx | pip install pympp
- MCP Server: npm install @asterpay/mcp-server (16 tools)
- Python: pip install asterpay
- Swagger docs: https://x402.asterpay.io/docs
- MPP Discovery: https://x402.asterpay.io/.well-known/mpp-methods.json

## Protocols

- x402 (HTTP 402 — Coinbase CDP standard)
- MPP (Machine Payments Protocol — Stripe/Tempo open standard)
- AP2 (Google Agent Payments Protocol)
- A2A (Google Agent-to-Agent Protocol)
- ERC-8004 (On-chain Agent Identity)
- ERC-8183 (Agentic Commerce Protocol)

## Supported Chains

Base, Ethereum, Solana, XRPL, BNB Chain, Polygon

## EU AI Act Compliance Tool

- [Attest — EU AI Act CLI](https://github.com/AsterPay/attest): Scan TypeScript codebases for AI SDK imports, run compliance checks, generate Annex IV documentation. Deadline: August 2, 2026.
- Try now: `npx @asterpay/attest scan`
- npm: [@asterpay/attest](https://www.npmjs.com/package/@asterpay/attest)

## Ecosystem / integration partners (not co-founders)

- Program: https://asterpay.io/partners/ — free to apply, open to all qualifying integrations. **These are technical/ecosystem partners, not founders of AsterPay** (AELIRA LTD operates AsterPay).
- Directory: https://asterpay.io/ecosystem/
- Listed in agent.json under `network.ecosystem_partners` for machine-readable discovery.
- Current listed integrations (infrastructure & programs only; customer names are never published without consent): InsumerAPI, Drip, Circle Alliance, ClawHub (OpenClaw), x402 Bazaar (CDP).

## Company

AELIRA LTD — Cyprus (MiCA jurisdiction)
Circle Alliance Member
EU AI Act: KYA assessed as limited-risk (Article 50 transparency in all API responses)