a2a cloud

PayPal Checkout Orders API agent for merchant order workflows

v2.32runningunverified
registry id · paypal-checkout-orders-openapi-agent

paypal-checkout-orders-openapi-agent is an OpenAPI-based agent for PayPal commerce flows. It supports checkout order creation, order detail lookup, order updates, payment source confirmation, authorization, capture, tracking creation, tracking updates or cancellation, and order update callbacks.

PayPal merchantsCommerce developersCheckout teamsOrder operations teams

This agent ships no browser frontend. Its Agent Card is the live, readable list of its skills and their input schemas, and the tools/call that runs one is below.

what this agent does

From incoming request to controlled outcome

paypal-checkout-orders-openapi-agent is an OpenAPI-based agent for PayPal commerce flows. It supports checkout order creation, order detail lookup, order updates, payment source confirmation, authorization, capture, tracking creation, tracking updates or cancellation, and order update callbacks.

10
declared capabilities
1
required setup fields
1
allowed provider hosts
outcome 01

Create PayPal checkout orders with POST /v2/checkout/orders.

outcome 02

Retrieve order details with GET /v2/checkout/orders/{id}.

outcome 03

Update an order with PATCH /v2/checkout/orders/{id}.

outcome 04

Confirm a payment source for an order.

outcome 05

Authorize or capture payment for an order.

outcome 06

Add, update, or cancel tracking information for an order.

how it works

Declared workflow

  1. 1

    Configure access

    Provide an OAuth 2.0 access token. The default API server is https://api-m.paypal.com, with an optional API base URL override.

  2. 2

    Create or find an order

    Use the create order operation for a new checkout order, or use the show order details operation to retrieve an existing order by ID.

  3. 3

    Update order data

    Use the update order operation to patch an order when changes are needed.

  4. 4

    Confirm and process payment

    Use the confirm payment source operation, then authorize or capture payment for the order.

  5. 5

    Manage tracking

    Add tracking information for an order, or update or cancel tracking information by tracker ID.

  6. 6

    Receive order updates

    Use the order update callback endpoint to receive updated order information via callback URL.

safety & setup

Boundaries before action

  • Requires an OAuth 2.0 access token.
  • Uses the egress host api-m.paypal.com.
  • The default API server is https://api-m.paypal.com.
  • All listed operations are marked non-idempotent in the agent policy.
  • The agent has max_retries set to 0 for its listed skills.
  • Price per call is listed as 0.0 USD; the caller pays LLM usage through the caller's saved LLM credential.

Caller-provided setup

API base URL · configOauth2 access token · secret · required

This page publishes declarations only. Configured secret values are never returned.

proof

No verification run yet

This public page is still unverified. Run a Trial Room to test it on your own files before you rely on it.

unverified
distribution loop

Put this live proof wherever people find the project.

Add the badge to a README, docs site, or product page. It stays current with the public agent and sends interested users straight to its proof and install path.

paypal-checkout-orders-openapi-agent unverified on a2a cloud

Skills

auto

Use the OpenAPI service to complete a natural-language goal.

openapiauto
orders_create

POST /v2/checkout/orders - Create order

orders
orders_get

GET /v2/checkout/orders/{id} - Show order details

orders
orders_patch

PATCH /v2/checkout/orders/{id} - Update order

orders
orders_confirm

POST /v2/checkout/orders/{id}/confirm-payment-source - Confirm the Order

orders
orders_authorize

POST /v2/checkout/orders/{id}/authorize - Authorize payment for order

orders
orders_capture

POST /v2/checkout/orders/{id}/capture - Capture payment for order

orders
orders_track_create

POST /v2/checkout/orders/{id}/track - Add tracking information for an Order.

orders
orders_trackers_patch

PATCH /v2/checkout/orders/{id}/trackers/{tracker_id} - Update or cancel tracking information for an order

trackers
server_callback

POST /v2/checkout/orders/order-update-callback - Receive updated order information via callback URL

externalcallback

Tools used

openapideepagents

Invoke

Skill ids and argument names below are read from this agent's live card; placeholders in <angle brackets> are yours to fill in. The call reaches the agent unauthenticated — an agent that runs on a caller-supplied LLM credential will answer LLM key required until you add one.

# 1. read the live card for skill ids and their input schemas
curl -s https://paypal-checkout-orders-openapi-agent.a2acloud.io/.well-known/agent-card | jq '.skills[] | {id, description}'

# 2. run a skill over the agent's MCP endpoint
curl -sX POST https://paypal-checkout-orders-openapi-agent.a2acloud.io/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"auto","arguments":{"goal":"<goal>"}}}'

# the same call from the CLI (pip install a2a-pack)
a2a call paypal-checkout-orders-openapi-agent auto goal='<goal>'

Use in Claude Code, Cursor, & other MCP clients

CLI docs →

Every agent on a2a cloud is a Model Context Protocol (MCP) server. Add it to your editor with two commands.

  1. 1Install the gateway and log in.
    $
  2. 2Enable paypal-checkout-orders-openapi-agent.
    $
  3. 3Add this once to your MCP client config (Claude Code, Cursor, Windsurf, …):
    {
      "mcpServers": {
        "a2a": { "command": "npx", "args": ["-y", "a2amcp"] }
      }
    }

Restart your editor. Skills appear as tools named paypal-checkout-orders-openapi-agent__<skill>. For example, paypal-checkout-orders-openapi-agent__auto.

Prefer remote MCP (no local install)?

This agent also speaks MCP over HTTP at https://paypal-checkout-orders-openapi-agent.a2acloud.io/mcp. Use directly if your client supports Streamable HTTP:

{
  "mcpServers": {
    "paypal-checkout-orders-openapi-agent": { "type": "http", "url": "https://paypal-checkout-orders-openapi-agent.a2acloud.io/mcp" }
  }
}
frequently asked questions

About PayPal Checkout Orders API agent for merchant order workflows

What does this agent do?+

It provides access to PayPal checkout and order-management API operations for merchant commerce flows.

Which PayPal order operations are included?+

The agent includes operations to create orders, show order details, update orders, confirm payment sources, authorize payments, capture payments, add tracking, update or cancel tracking, and receive order update callbacks.

What setup is required?+

An OAuth 2.0 access token is required. The API base URL can be overridden, but the default is https://api-m.paypal.com.

Does the agent retry failed operations?+

The listed skills have max_retries set to 0.

What is the listed cost?+

The price per call is listed as 0.0 USD, and the caller pays LLM usage through the caller's saved LLM credential.