---

name: commerce-checkout description: Use when managing shopping carts, checkout flows, or implementing the Agentic Commerce Protocol (ACP).

Commerce Checkout Skill

Domain knowledge for shopping cart and checkout operations using the Agentic Commerce Protocol (ACP).

Agentic Commerce Protocol (ACP)

ACP is a standardized protocol for AI agents to interact with commerce systems. It defines:

1. Cart Lifecycle - Creation, modification, completion
2. Checkout Flow - Address, shipping, payment, confirmation
3. Recovery Patterns - Abandoned cart handling

Cart States

Checkout Flow

Standard Flow

Copy1. Create Cart
   - Guest: email + name
   - Customer: customerId

2. Add Items
   - SKU, name, quantity, price
   - Can add multiple items

3. Set Shipping Address
   - firstName, lastName
   - line1, line2 (optional)
   - city, state, postalCode, country

4. Select Shipping Method
   - Get rates based on address
   - Choose carrier/service

5. Apply Discounts (optional)
   - Coupon codes
   - Automatic discounts

6. Set Payment
   - Method: credit_card, paypal, crypto
   - Token from payment provider

7. Complete Checkout
   - Validates all required fields
   - Creates order
   - Returns orderId, orderNumber

Cart Totals

Formula:

CopygrandTotal = subtotal + taxAmount + shippingAmount - discountAmount

Payment Methods

Fulfillment Types

Cart Expiration

• Default: 24 hours
• Custom: Set expiresInMinutes on create
• Expired carts cannot be modified
• Recovery: Create new cart with same items

Abandoned Cart Recovery

Carts become "abandoned" when:

• User navigates away without completing
• Explicit abandon marking
• Inactivity threshold reached

Recovery workflow:

1. get_abandoned_carts - List recovery candidates
2. Send reminder email (external)
3. User returns and resumes checkout
4. Or create new cart with recovered items

Common Errors

Best Practices

1. Save cart ID - Store for session continuity
2. Validate incrementally - Check each step
3. Handle failures gracefully - Preserve cart state
4. Show clear totals - Break down all charges
5. Confirm before complete - Final review step

Integration Notes

Creating Cart for Guest

Copy{
  customerEmail: "guest@example.com",
  customerName: "Guest User",
  currency: "USD"
}

Creating Cart for Customer

Copy{
  customerId: "uuid-of-customer",
  currency: "USD"
}

Cart Item Structure

Copy{
  sku: "WIDGET-001",
  name: "Premium Widget",
  description: "High quality widget",
  quantity: 2,
  unitPrice: 29.99,
  imageUrl: "https://..."
}