ucp-embedded-checkout

Implement UCP Embedded Checkout Protocol with JSON-RPC 2.0 over postMessage.

35|16|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/OrcaQubits/agentic-commerce-claude-plugins --skill ucp-embedded-checkout
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ucp-embedded-checkout
Source: https://github.com/OrcaQubits/agentic-commerce-claude-plugins/tree/main/ucp-agentic-commerce/skills/ucp-embedded-checkout
Command: npx skills add https://github.com/OrcaQubits/agentic-commerce-claude-plugins --skill ucp-embedded-checkout

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables seamless integration of merchant-hosted checkout UIs within an agent's workflow when human intervention is required, ensuring a secure and user-friendly escalation path.

Core Features & Use Cases

  • Secure Communication: Utilizes JSON-RPC 2.0 over postMessage for robust communication between the merchant's iframe and the host platform.
  • Delegated Capabilities: Allows the merchant to delegate specific actions (e.g., payment credential acquisition) to the host, streamlining the checkout process.
  • Use Case: When an agent-initiated checkout requires a buyer to confirm details or select shipping options via a merchant's website, this Skill facilitates that interaction securely within an iframe.

Quick Start

Use the ucp-embedded-checkout skill to initiate the embedded checkout flow by opening the provided continue URL in a sandboxed iframe.

Frequently Asked Questions about ucp-embedded-checkout

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle human escalation for agent-initiated checkout in an iframe?

Human escalation for agent-initiated checkout in an iframe is handled by implementing the UCP Embedded Checkout Protocol to facilitate secure communication between the merchant UI and host platform. It allows buyers to confirm details or select shipping options securely.

How does JSON-RPC 2.0 over postMessage work for iframe checkout communication?

JSON-RPC 2.0 over postMessage for iframe checkout communication works by establishing a secure messaging channel between the merchant's iframe and the host platform, enabling delegated actions like payment credential acquisition and order completion.

Do I need Content Security Policy and origin validation for embedded checkout?

Yes, Content Security Policy, origin validation, and sandboxing are required for embedded checkout to adhere to strict security requirements, ensuring the iframe-based checkout UI escalation protects payment credentials and buyer interactions.

What is the best way to delegate payment credential acquisition to a host platform?

The best way to delegate payment credential acquisition to a host platform is using the UCP Embedded Checkout Protocol, which allows the merchant iframe to securely request and facilitate actions from the host via JSON-RPC 2.0.

Can I use a sandboxed iframe for agent checkout workflows requiring buyer confirmation?

Yes, you can use a sandboxed iframe for agent checkout workflows requiring buyer confirmation by opening the provided continue URL within the iframe, ensuring secure communication and strict origin validation during the escalation process.

When should I use embedded checkout over direct API calls for payment processing?

Embedded checkout should be used over direct API calls when an agent-initiated checkout requires human intervention, such as when a buyer needs to confirm details or select shipping options via a merchant's website within a secure iframe.