Checkout 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-1/carts/{cartId}/checkout
Oauth2 Oauth2

Checks out all items in the specific cart.

Path parameters

  • cartId string(uuid) Required

    The unique identifier of the cart to checkout.

application/json

Body Required

  • actionsCancelRedirectUrl string(uri)

    The URL to redirect the client after cancelling authorization actions.

  • actionsFailureRedirectUrl string(uri)

    The URL to redirect the client after failing to submit authorization actions.

  • actionsSuccessRedirectUrl string(uri)

    The URL to redirect the client after successfully submitting authorization actions.

  • metadata object

    The metadata to pass to the payment service during payment authorization.

    Additional properties are allowed.

Responses

  • 200 application/json

    The checkout process has either been completed or has failed.

    Hide response attribute Show response attribute object
    • data object Required

      The cart that has been checked out.

      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, or the cart has no payment method set.

  • 401

    Client authentication failed.

  • 403

    Missing one or more required scopes.

  • 404

    The specified cart was not found.

  • 409

    The cart already has a checkout in progress, has already completed a checkout, is being modified concurrently, or has reached its checkout attempt limit.

  • 500

    An unexpected error occurred.

POST /2026-1/carts/{cartId}/checkout 
curl \
 --request POST 'https://api.pace.cloud/cart/2026-1/carts/9239a6a6-de5b-4ccc-ba58-40ede174a5a0/checkout' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "actionsCancelRedirectUrl": "https://example.com/actions/cancel",
  "actionsFailureRedirectUrl": "https://example.com/actions/failure",
  "actionsSuccessRedirectUrl": "https://example.com/actions/success",
  "metadata": {}
}'
Request examples 
{
  "actionsCancelRedirectUrl": "https://example.com/actions/cancel",
  "actionsFailureRedirectUrl": "https://example.com/actions/failure",
  "actionsSuccessRedirectUrl": "https://example.com/actions/success",
  "metadata": {}
}
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"
  }
}