# UCP Checkout for Magento 2

> Free Magento 2 module for UCP checkout: agents build the order over REST with live shipping rates and coupons, and the buyer pays on your own checkout.

Source: https://angeo.dev/modules/ucp-checkout/
Updated: 2026-10-17

Transact - Open source

# UCP Checkout for Magento 2

angeo/module-ucp-checkout

- UCP
- spec 2026-08-25
- REST
- MIT

**AI agents build the order. The buyer pays on your own checkout.** This module adds the UCP checkout capability with the discount, fulfillment and order extensions, so any agent that speaks UCP can create a checkout session with live totals.

```
composer require angeo/module-ucp-checkout
bin/magento module:enable Angeo_UcpCheckout
bin/magento setup:upgrade
bin/magento cache:flush
```

Full setup, every setting with its default, and the CLI commands: [**UCP Checkout reference ->**](https://angeo.dev/docs/modules/ucp-checkout/)

## What it does

Four things to know before you install.

### A real checkout session

Create, get, update, complete and cancel  -  as the UCP spec defines them. The agent sets items, the buyer's email, a coupon code and a shipping address, and sees live Magento totals.

### Your live shipping rates

The agent sends an address and gets your real shipping options for it, cheapest first. Countries outside your allowed list come back as a clear, fixable error.

### Handoff, not payment

Complete Checkout returns `requires_escalation` with a `continue_url`. The buyer opens it, lands on your normal checkout with everything set, and pays as usual. No card data, no payment handler, no PCI scope.

### Orders and signed webhooks

After the order, the platform that created the checkout can read it  -  shipments, tracking, refunds. If its profile asks for webhooks, the store sends signed updates and retries on failure.

Requires [UCP Profile](https://angeo.dev/modules/ucp/) 2.2+, which advertises checkout only when this module is installed. Add [UCP Catalog](https://angeo.dev/modules/ucp-catalog/) so agents can find the items first.

## Requirements

| Magento | 2.4.6+ (Open Source, Mage-OS, Adobe Commerce) |
| PHP | 8.1 - 8.5 |
| Requires | `angeo/module-ucp` |
| Latest version | 1.1.0 |
| Licence | MIT  -  free, no licence key, no account, no telemetry |

## Works with

[UCP Profile](https://angeo.dev/modules/ucp/) - [UCP Catalog](https://angeo.dev/modules/ucp-catalog/) - [UCP Checkout over MCP](https://angeo.dev/modules/ucp-checkout-mcp/) - [AI Agent Activity](https://angeo.dev/modules/agent-activity/)

## Not sure whether you need this one?

Run the free scan or the CLI audit first. It shows which signals your store is missing, and which module fixes each one.

[Scan my store](https://angeo.dev/ai-magento-audit/)[All modules](https://angeo.dev/modules/)

## Questions

Does the agent take payment?
No. The buyer pays on your own checkout through continue_url.
Which shipping methods are offered?
Your live Magento rates for the address the agent sends. Pickup is not offered yet.
Is it safe to retry calls?
Yes. Send an Idempotency-Key header. The same key with the same body returns the stored answer.
Can agents use MCP instead of REST?
Yes, with UCP Checkout over MCP. It shares the same sessions.

## Related

- [UCP for Magento 2 - complete guide](https://angeo.dev/magento-ucp/)

- [UCP checkout - definition](https://angeo.dev/ucp-checkout-definition/)

- [UCP - definition](https://angeo.dev/ucp-definition/)

- [Agentic checkout - definition](https://angeo.dev/agentic-checkout-definition/)

- [UCP Checkout reference](https://angeo.dev/docs/modules/ucp-checkout/)

Free and MIT licensed. Checked 16 October 2026 against version 1.1.0.
