ACP for WooCommerce

Agentic Commerce Protocol integration for WooCommerce stores

Enable AI-powered commerce through standardized API endpoints and product feeds

Documentation • Shora Dashboard • API Keys • Support

Overview

This plugin implements the Agentic Commerce Protocol (ACP) for WooCommerce, providing standardized API endpoints that enable AI agents to discover, browse, and purchase products from your store. The implementation follows the official ACP specification maintained by OpenAI and Stripe.

ACP Compliance: This plugin implements the official Agentic Commerce Protocol specification with full OpenAPI compliance and JSON Schema validation.

Requires Shora Account: To use this plugin, you need a Shora account and API keys from app.shora.cloud.

Features

Core ACP Integration

REST API Endpoints: Complete ACP-compatible checkout session management
Product Feed: Standardized product catalog at /acp/feed
Webhook Support: Real-time order event notifications
Security: Bearer token authentication with idempotency support

WooCommerce Integration

Cart Integration: Native WooCommerce cart management
Order Processing: Standard WooCommerce order creation
Product Sync: Automatic product catalog synchronization
Payment Processing: Integrated payment gateway support

Security & Reliability

HMAC Signatures: Secure webhook verification
Idempotency: Redis/WP Transient support for duplicate prevention
Header Validation: Comprehensive request validation
Error Handling: Professional error logging and recovery
Event Sourcing: Complete audit trail with version history
Real-time Events: Instant webhook notifications via WordPress hooks
Production Monitoring: Built-in logging and performance tracking

Quick Start

Prerequisites

WordPress 5.8 or higher
WooCommerce 8.0 or higher
PHP 8.0 or higher
MySQL 5.7 or higher
Shora Account (required) - Sign up at app.shora.cloud

Installation

Get Shora API Keys
- Sign up at app.shora.cloud
- Navigate to API Keys
- Generate your API key and webhook secret
Install the Plugin
```
git clone https://github.com/shoraco/-ACP-Agentic-Commerce-Protocol-for-Woocommerce.git
```
- Upload to /wp-content/plugins/
- Activate in WordPress admin
- Ensure WooCommerce is installed and active
Configure Plugin
- Go to WooCommerce → Settings → ACP
- Enter your Shora API key from app.shora.cloud/keys
- Configure webhook settings
- Test the connection

Test the Integration

Create a checkout session

curl -X POST https://yourstore.com/wp-json/acp/v1/checkout_sessions \
  -H "Authorization: Bearer YOUR_SHORA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: test-123" \
  -d '{
    "items": [
      {"sku": "product-123", "quantity": 1}
    ]
  }'

Access product feed
```
curl https://yourstore.com/acp/feed
```
Check webhook events
- Place a test order in WooCommerce
- Verify webhook events are sent to Shora dashboard
- Monitor events at app.shora.cloud/webhooks

API Endpoints

ACP-Compliant Checkout Sessions

This plugin implements the official ACP Checkout API specification:

Method	Endpoint	Description	ACP Spec
`POST`	`/wp-json/acp/v1/checkout_sessions`	Create checkout session	✅ Compliant
`GET`	`/wp-json/acp/v1/checkout_sessions/{id}`	Get session details	✅ Compliant
`PUT`	`/wp-json/acp/v1/checkout_sessions/{id}`	Update session	✅ Compliant
`POST`	`/wp-json/acp/v1/checkout_sessions/{id}/complete`	Complete payment	✅ Compliant
`POST`	`/wp-json/acp/v1/checkout_sessions/{id}/cancel`	Cancel session	✅ Compliant

Product Feed

Method	Endpoint	Description	ACP Spec
`GET`	`/acp/feed`	Get product catalog (JSON)	✅ Compliant

ACP Specification Compliance

OpenAPI 3.0: Full compliance with ACP OpenAPI spec
JSON Schema: Validates against ACP JSON schemas
RFC Compliance: Follows ACP RFC specifications
Examples: Compatible with ACP examples

Configuration

Environment Variables

# API Configuration
ACP_API_KEY=your_api_key_here
ACP_WEBHOOK_SECRET=your_webhook_secret_here
ACP_SANDBOX_MODE=true

# Redis Configuration (Optional)
ACP_REDIS_ENABLED=false
ACP_REDIS_HOST=localhost
ACP_REDIS_PORT=6379
ACP_REDIS_PASSWORD=
ACP_REDIS_DATABASE=0

WordPress Options

The plugin stores configuration in WordPress options:

acp_api_key: API authentication key
acp_webhook_secret: Webhook signature secret
acp_sandbox_mode: Enable/disable sandbox mode
acp_enable_feed: Enable/disable product feed
acp_enable_webhooks: Enable/disable webhook events
acp_webhook_url: Target webhook URL

Webhook Events

The plugin sends webhook events for order status changes:

{
  "webhook_id": "webhook_abc123",
  "event_type": "order.status_changed",
  "order_id": 12345,
  "old_status": "pending",
  "new_status": "processing",
  "amount": "100.00",
  "currency": "TRY",
  "customer": {
    "id": 1,
    "email": "customer@example.com",
    "name": "John Doe"
  },
  "items": [...],
  "metadata": {...}
}

Shora Dashboard Integration

Account Management

API Keys: Manage your API keys at app.shora.cloud/keys
Webhooks: Configure webhook endpoints at app.shora.cloud/webhooks
Analytics: View transaction insights and reports
Settings: Configure your store settings and preferences

Advanced Features

Payment Processing: Multi-provider payment gateway integration
Real-time Monitoring: Live transaction monitoring and alerts
Enterprise Support: Priority support and SLA
Custom Integrations: Tailored solutions for specific requirements

Getting Started with Shora

Sign up at app.shora.cloud
Generate API keys from your dashboard
Configure webhooks for real-time events
Monitor transactions and analytics

Need Help? Contact Support | Documentation

Why Choose ACP for WooCommerce?

🚀 AI-Ready Commerce

Enable your WooCommerce store to participate in the AI revolution. Let ChatGPT and AI agents discover, browse, and purchase from your store through natural language interactions.

🛡️ Enterprise-Grade Security

Bearer Token Authentication - Secure API access
HMAC Signature Validation - Tamper-proof webhooks
Idempotency Protection - Prevent duplicate transactions
Header Validation - Comprehensive request security
Event Sourcing - Complete audit trail

📊 Real-Time Analytics

Transaction Monitoring - Live order tracking
Performance Metrics - API response times and success rates
Error Tracking - Comprehensive logging and debugging
Webhook Analytics - Delivery success and failure rates

🔧 Developer Experience

Professional Admin Interface - Easy configuration and monitoring
Comprehensive Documentation - Complete API reference
Testing Tools - Built-in connection testing
Log Management - View, download, and clear logs
Cron Jobs - Automated maintenance and cleanup

🌐 Production Ready

WordPress Integration - Native WooCommerce compatibility
Theme Compatibility - Works with all modern WordPress themes
Performance Optimized - Efficient database queries and caching
Scalable Architecture - Handles high-volume transactions
Error Recovery - Automatic retry mechanisms

💰 Cost Effective

Free Plugin - No licensing fees
Shora API Integration - Pay only for what you use
Efficient Resource Usage - Optimized for WordPress environment
No Vendor Lock-in - Open source MIT license

Comparison with Other ACP Implementations

🆚 ACP for WooCommerce vs Serverless Solutions

Feature	ACP for WooCommerce	Serverless ACP
Deployment	WordPress Plugin	AWS Lambda + DynamoDB
Setup Time	5 minutes	30+ minutes
Maintenance	WordPress Admin	AWS Console
Cost	Free + Shora API	AWS Infrastructure
WordPress Integration	Native	External API
Theme Compatibility	All WordPress Themes	N/A
Admin Interface	Built-in	Custom Development
Logging	WordPress Logs	CloudWatch
Updates	WordPress Updates	Manual Deployment

🎯 Why WordPress Users Choose ACP for WooCommerce

✅ Instant Setup

No AWS knowledge required
Familiar WordPress interface
One-click activation

✅ Native Integration

Seamless WooCommerce integration
No external dependencies
WordPress-native security

✅ Cost Effective

No infrastructure costs
Pay only for Shora API usage
No vendor lock-in

✅ Developer Friendly

WordPress development standards
Familiar PHP codebase
Extensive documentation

✅ Production Ready

Battle-tested WordPress platform
Automatic updates and security
Professional support

Development

Local Development

Clone the repository

git clone https://github.com/shora-co/woocommerce-acp-integration.git
cd woocommerce-acp-integration

Set up WordPress environment

# Using Docker
docker-compose up -d

# Or using local WordPress
wp core download
wp plugin install woocommerce --activate

Run tests
```
phpunit tests/
```

Code Structure

woocommerce-acp-integration/
├── woocommerce-acp.php          # Main plugin file
├── includes/
│   ├── class-acp-api.php         # REST API endpoints
│   ├── class-acp-auth.php        # Authentication & security
│   ├── class-acp-feed-generator.php # Product feed
│   ├── class-acp-webhook.php       # Webhook handler
│   └── class-acp-model.php        # Data models
├── tests/                        # Unit tests
└── README.md                     # Documentation

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

Documentation: docs.shora.co
Community: Discord
Issues: GitHub Issues
Email: support@shora.co

Changelog

1.0.0

Initial release
ACP checkout session management
Product feed generation
Webhook event handling
Security and authentication
WooCommerce integration

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

Documentation: docs.shora.co
Dashboard: app.shora.cloud
API Keys: app.shora.cloud/keys
Issues: GitHub Issues
Contact: support@shora.co

ACP for WooCommerce - Professional implementation of the Agentic Commerce Protocol for WooCommerce stores.

Built by Shora - Commerce infrastructure for modern applications.

Requires Shora Account: Sign up at app.shora.cloud to get started.

About

Professional WordPress plugin implementing the Agentic Commerce Protocol (ACP) for WooCommerce stores. This plugin provides a complete implementation of the official ACP specification maintained by OpenAI and Stripe.

ACP Specification Compliance:

Official ACP Implementation - Full compliance with agentic-commerce-protocol/agentic-commerce-protocol
OpenAPI 3.0 - Implements ACP OpenAPI specification
JSON Schema - Validates against ACP JSON schemas
RFC Compliance - Follows ACP RFC specifications

Key Features:

WordPress Integration - Native WooCommerce integration with admin interface
ACP Compliance - Full OpenAI and Stripe ACP specification implementation
Security First - Bearer token authentication, HMAC signatures, idempotency
Real-time Events - Webhook notifications for order lifecycle events
Production Ready - Comprehensive logging, error handling, and monitoring
Developer Friendly - Professional admin interface with configuration options

Perfect for:

E-commerce stores wanting AI agent integration
Developers building AI-powered commerce solutions
Businesses looking to enable ChatGPT and AI agent shopping
WooCommerce stores seeking modern API capabilities

Resources:

License: MIT License - View License

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
assets		assets
build		build
includes		includes
COMMIT_INFO.md		COMMIT_INFO.md
LICENSE		LICENSE
README.md		README.md
build-plugin.sh		build-plugin.sh
validate-plugin.sh		validate-plugin.sh
woocommerce-acp.php		woocommerce-acp.php

License

shoraco/Shora-ACP-Agentic-Commerce-Protocol-for-Woocommerce

Folders and files

Latest commit

History

Repository files navigation

ACP for WooCommerce

Overview

Features

Core ACP Integration

WooCommerce Integration

Security & Reliability

Quick Start

Prerequisites

Installation

Test the Integration

API Endpoints

ACP-Compliant Checkout Sessions

Product Feed

ACP Specification Compliance

Configuration

Environment Variables

WordPress Options

Webhook Events

Shora Dashboard Integration

Account Management

Advanced Features

Getting Started with Shora

Why Choose ACP for WooCommerce?

🚀 AI-Ready Commerce

🛡️ Enterprise-Grade Security

📊 Real-Time Analytics

🔧 Developer Experience

🌐 Production Ready

💰 Cost Effective

Comparison with Other ACP Implementations

🆚 ACP for WooCommerce vs Serverless Solutions

🎯 Why WordPress Users Choose ACP for WooCommerce

Development

Local Development

Code Structure

Contributing

License

Support

Changelog

1.0.0

License

Support

About

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Contributors 2

Uh oh!

Languages

Packages