# A2A Commerce Gateway API **Canonical:** https://apis.io/apis/greenhelix-net/a2a-commerce-gateway-api/ **Provider:** Green Helix — https://apis.io/providers/greenhelix-net/ **Base URL:** https://api.greenhelix.net **Documentation:** https://api.greenhelix.net/docs A2A Commerce Gateway API is published by [Green Helix](https://apis.io/providers/greenhelix-net/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Payments, Escrow, Billing, Identity, and Marketplace. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference. REST API for agent-to-agent commerce: billing and wallets, payment intents and escrow, subscriptions, identity and reputation, marketplace, trust scoring, messaging and negotiation, disputes, webhooks, event bus, API keys and database operations. 114 paths / 132 operations under /v1 with a global choice of Bearer API key, X-API-Key or x402 X-PAYMENT security. The former POST /v1/execute tool dispatcher is 410 Gone (sunset 2026-10-01); POST /v1/batch remains for multi-tool dispatch and is how the MCP server invokes tools. ## Operations (60 of 132) | Method | Path | Summary | |---|---|---| | GET | `/livez` | Livez | | GET | `/readyz` | Readyz | | GET | `/v1/health` | Health | | GET | `/v1/pricing` | Pricing List | | GET | `/v1/pricing/summary` | Pricing Summary | | GET | `/v1/pricing/tiers` | Pricing Tiers | | GET | `/v1/pricing/{tool}` | Pricing Detail | | POST | `/v1/execute` | Execute | | POST | `/v1/batch` | Batch | | GET | `/v1/events/stream` | Event Stream | | GET | `/v1/ws` | Websocket Upgrade Fallback | | GET | `/v1/onboarding` | Onboarding Handler | | POST | `/v1/register` | Register | | GET | `/v1/checkout/success` | Checkout Success | | GET | `/v1/checkout/cancelled` | Checkout Cancelled | | POST | `/v1/checkout` | Create Checkout | | POST | `/v1/stripe-webhook` | Stripe Webhook | | GET | `/v1/billing/wallets/{agent_id}/balance` | Get Balance | | POST | `/v1/billing/wallets` | Create Wallet | | POST | `/v1/billing/wallets/{agent_id}/deposit` | Deposit | | POST | `/v1/billing/wallets/{agent_id}/withdraw` | Withdraw | | POST | `/v1/billing/wallets/{agent_id}/freeze` | Freeze Wallet | | POST | `/v1/billing/wallets/{agent_id}/unfreeze` | Unfreeze Wallet | | GET | `/v1/billing/wallets/{agent_id}/transactions` | Get Transactions | | GET | `/v1/billing/wallets/{agent_id}/usage` | Get Usage Summary | | GET | `/v1/billing/wallets/{agent_id}/analytics` | Get Service Analytics | | GET | `/v1/billing/wallets/{agent_id}/revenue` | Get Revenue Report | | GET | `/v1/billing/wallets/{agent_id}/timeseries` | Get Metrics Timeseries | | PUT | `/v1/billing/wallets/{agent_id}/budget` | Set Budget Cap | | GET | `/v1/billing/wallets/{agent_id}/budget` | Get Budget Status | | GET | `/v1/billing/leaderboard` | Get Agent Leaderboard | | GET | `/v1/billing/discounts` | Get Volume Discount | | GET | `/v1/billing/estimate` | Estimate Cost | | GET | `/v1/billing/exchange-rates` | Get Exchange Rate | | POST | `/v1/billing/keys` | Create Billing Api Key | | GET | `/v1/billing/keys` | List Billing Api Keys | | POST | `/v1/billing/wallets/{agent_id}/convert` | Convert Currency | | POST | `/v1/disputes` | Open Dispute | | GET | `/v1/disputes` | List Disputes | | GET | `/v1/disputes/{dispute_id}` | Get Dispute | | POST | `/v1/disputes/{dispute_id}/respond` | Respond To Dispute | | POST | `/v1/disputes/{dispute_id}/resolve` | Resolve Dispute | | POST | `/v1/payments/intents/split` | Create Split Intent | | POST | `/v1/payments/intents` | Create Intent | | GET | `/v1/payments/intents` | List Intents | | GET | `/v1/payments/intents/{intent_id}` | Get Intent | | POST | `/v1/payments/intents/{intent_id}/capture` | Capture Intent | | POST | `/v1/payments/intents/{intent_id}/partial-capture` | Partial Capture | | POST | `/v1/payments/intents/{intent_id}/refund` | Refund Intent | | POST | `/v1/payments/escrows/performance` | Create Performance Escrow | | POST | `/v1/payments/escrows` | Create Escrow | | GET | `/v1/payments/escrows` | List Escrows | | GET | `/v1/payments/escrows/{escrow_id}` | Get Escrow | | POST | `/v1/payments/escrows/{escrow_id}/release` | Release Escrow | | POST | `/v1/payments/escrows/{escrow_id}/cancel` | Cancel Escrow | | POST | `/v1/payments/escrows/{escrow_id}/check-performance` | Check Performance Escrow | | POST | `/v1/payments/settlements/{settlement_id}/refund` | Refund Settlement | | GET | `/v1/payments/history` | Get Payment History | | POST | `/v1/payments/subscriptions/process-due` | Process Due Subscriptions | | POST | `/v1/payments/subscriptions` | Create Subscription | …and 72 more operations. They are listed in full on the page. ## Machine-readable artifacts (9) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/greenhelix-net/refs/heads/main/openapi/greenhelix-net-a2a-commerce-gateway-openapi.yml - **OpenAPI** — https://api.greenhelix.net/v1/openapi.json - **Overlay** — https://raw.githubusercontent.com/api-evangelist/greenhelix-net/refs/heads/main/overlays/greenhelix-net-a2a-commerce-gateway-overlay.yaml - **Documentation** — https://www.greenhelix.net/docs.html - **APIReference** — https://api.greenhelix.net/docs - **APIReference** — https://github.com/mirni/a2a/blob/main/docs/api-reference.md - **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/greenhelix-net/refs/heads/main/mcp/greenhelix-net-tool-crosswalk.yml - **Sandbox** — https://www.greenhelix.net/docs.html#sandbox - **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/greenhelix-net/refs/heads/main/apis.yml ## Tags Payments, Escrow, Billing, Identity, Marketplace, Trust, Messaging, Disputes, Webhook --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/greenhelix-net/a2a-commerce-gateway-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/greenhelix-net/.