Loading…
Docs
Learn how to implement UCP checkout endpoints and handle payments for agentic commerce flows.
Last updated: February 3, 2026
This content is based on official sources and ecosystem developments:
UCP defines standard checkout flows that work with any payment provider.
AI agent creates a cart with selected products:
{
"items": [
{
"product_id": "prod_123",
"variant_id": "var_123_1",
"quantity": 1
}
]
}
AI agent provides shipping address:
{
"shipping_address": {
"street": "123 Main St",
"city": "San Francisco",
"state": "CA",
"zip": "94102",
"country": "US"
}
}
Your endpoint returns available shipping options:
{
"shipping_options": [
{
"id": "standard",
"name": "Standard Shipping",
"cost": {
"amount": 599,
"currency": "USD"
},
"estimated_days": 5
}
]
}
AI agent selects payment method (handled by your payment provider):
{
"payment_method": {
"type": "card",
"token": "payment_token_from_provider"
}
}
Your endpoint processes payment and returns order confirmation:
{
"order_id": "order_123",
"status": "confirmed",
"estimated_delivery": "2026-02-10"
}
UCP works with any payment provider:
Return clear error messages:
{
"error": {
"code": "payment_failed",
"message": "Payment method declined",
"retryable": true
}
}
Handle out-of-stock items:
{
"error": {
"code": "out_of_stock",
"message": "Product no longer available",
"items": ["prod_123"]
}
}