Costruisci con UCP
Guide, riferimenti API e SDK per connettere il tuo e-commerce o il tuo agente AI alla rete globale UCP.
Quick Start
Parti da zero in 5 minuti con Node.js o Python
Specifiche
Documentazione completa del protocollo su ucp.dev
GitHub
SDK, esempi e test di conformance
Concetti Chiave
UCP si basa su un'architettura componibile e transport-agnostic. I business dichiarano le loro capability in un profilo standardizzato, permettendo alle piattaforme di scoprirle automaticamente.
Capability
Funzionalità che un business può implementare: Checkout, Identity Linking, Order, Payment Token Exchange.
/.well-known/ucp → capabilities[]Extensions
Funzionalità opzionali che estendono le capability core: Discounts, Fulfillment Options, Loyalty.
capability.extensions[]Transport
UCP supporta REST, JSON-RPC, MCP e A2A. Scegli quello che si integra meglio nel tuo stack.
Content-Type: application/jsonAP2 (Payments)
Agent Payments Protocol per autorizzazioni sicure con mandati e credenziali verificabili.
payment.mandate.credentialEsempio: Discovery Endpoint
{
"api_version": "1.0",
"business": {
"name": "My Store",
"logo_url": "https://..."
},
"capabilities": [
{
"type": "checkout",
"endpoint": "https://api.store.com/ucp/checkout",
"extensions": ["discounts", "gift_wrap"]
},
{
"type": "identity_linking",
"endpoint": "https://auth.store.com/oauth2"
}
]
}