Submit checkout actions for a cart.

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://developer.pace.cloud/doc/cart/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Cart MCP server": {
    "url": "https://developer.pace.cloud/doc/cart/mcp"
  }
}
Close
POST /2026-2/carts/{cartId}/actions
Oauth2 Oauth2

Submits checkout actions for a cart. Render each INPUT action according to its format and validate the value against its format, pattern, minimum and maximum before submitting.

Path parameters

  • cartId string(uuid) Required

    The unique identifier of the cart to submit checkout actions for.

application/json

Body Required

  • actions object Required

    The actions to submit for the cart checkout.

    One of:
    INPUT object MULTI_SELECT object ONE_OF object SINGLE_SELECT object

Responses

  • 200 application/json

    The checkout actions were successfully submitted for the cart.

    Hide response attribute Show response attribute object
    • data object Required

      The cart with the submitted actions.

      Hide data attributes Show data attributes object
      • checkout object Required

        The checkout associated with this cart.

        Hide checkout attributes Show checkout attributes object
        • actions object Required

          The actions that are required to complete the checkout process.

          One of:
          INPUT object MULTI_SELECT object ONE_OF object SINGLE_SELECT object
        • actionsUrl string(uri) | null Required

          The URL which the client may follow to complete the checkout process.

        • cancelledAt string(date-time) | null Required

          The timestamp when the cart checkout was cancelled.

        • completedAt string(date-time) | null Required

          The timestamp when the cart checkout was completed.

        • failedAt string(date-time) | null Required

          The timestamp when the cart checkout failed.

        • failureCode string | null Required

          The failure code of the cart checkout. Free-form: new codes are introduced without a version change, so treat an unrecognized value as an unspecified failure.

        • startedAt string(date-time) Required

          The timestamp when the cart checkout was started.

        • status string Required

          The status of the cart checkout.

          Values are PROCESSING, ACTIONS_REQUIRED, COMPLETED, CANCELLED, or FAILED.

      • clientId string Required

        The unique identifier of the client through which this cart was created.

      • createdAt string(date-time) Required

        The timestamp when the cart was created.

      • expiresAt string(date-time) | null Required

        The timestamp at which the cart lapses if nothing interacts with it before then. Every interaction with the cart pushes it further out, so read the current value rather than assuming a fixed window. It is null once the checkout has completed.

      • id string(uuid) Required

        The unique identifier for the cart.

      • paymentMethodId string(uuid) | null Required

        The unique identifier of the selected payment method for this cart.

      • poiId string(uuid) Required

        The unique identifier of the POI associated with this cart.

      • status string Required

        The current status of the cart.

        Values are OPEN, PROCESSING, ACTIONS_REQUIRED, COMPLETED, CANCELLED, or FAILED.

      • updatedAt string(date-time) Required

        The timestamp when the cart was last updated.

      • userId string(uuid) Required

        The unique identifier of the user who owns this cart.
  • 400

    The request parameters are missing or invalid.

  • 401

    Client authentication failed.

  • 403

    Missing one or more required scopes.

  • 404

    The specified cart was not found.

  • 409

    The cart has no checkout awaiting actions.

  • 500

    An unexpected error occurred.

POST /2026-2/carts/{cartId}/actions 
curl \
 --request POST 'https://api.pace.cloud/cart/2026-2/carts/9239a6a6-de5b-4ccc-ba58-40ede174a5a0/actions' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "actions": {
    "cartItemId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "name": "CAR_MILEAGE",
    "type": "INPUT",
    "value": "74953"
  }
}'
Request examples 
{
  "actions": {
    "cartItemId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "name": "CAR_MILEAGE",
    "type": "INPUT",
    "value": "74953"
  }
}
Response examples (200) 
{
  "data": {
    "checkout": {
      "actions": {
        "cartItemId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "default": "7495345",
        "description": "The car mileage is required to complete the cart checkout.",
        "format": "TEXT",
        "label": "Car Mileage",
        "maximum": "100.00",
        "minimum": "10.00",
        "name": "CAR_MILEAGE",
        "optional": false,
        "pattern": "^[0-9]+$",
        "type": "INPUT"
      },
      "actionsUrl": "https://example.com/checkout/actions",
      "cancelledAt": "2023-05-15T14:30:00.000Z",
      "completedAt": "2023-05-15T15:00:00.000Z",
      "failedAt": "2023-05-15T14:30:00.000Z",
      "failureCode": "INSUFFICIENT_FUNDS",
      "startedAt": "2023-05-15T14:00:00.000Z",
      "status": "PROCESSING"
    },
    "clientId": "pace-drive-app",
    "createdAt": "2023-05-15T14:00:00.000Z",
    "expiresAt": "2023-05-16T14:30:00.000Z",
    "id": "ae1b58ef-ba5c-4240-b130-51fcf067d40d",
    "paymentMethodId": "ecbec75f-7ca4-4017-a485-6a4836de5d25",
    "poiId": "96a939ea-28d4-4228-b45c-192904ba91d7",
    "status": "OPEN",
    "updatedAt": "2023-05-15T14:15:00.000Z",
    "userId": "e9166a60-1f92-4a5d-a192-c2f6b662e9d9"
  }
}