Set a payment method for a cart. Beta

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 /2025-3/carts/{cartId}/payment-method
Oauth2 Oauth2

Sets a payment method for a cart.

Path parameters

  • cartId string(uuid) Required

    The unique identifier of the cart to set the payment method for.

application/json

Body Required

  • paymentMethodId string(uuid) Required

    The unique identifier of the payment method to set for the cart.

Responses

  • 200 application/json

    The payment method was successfully set for the cart.

    Hide response attribute Show response attribute object
    • data object Required

      The cart that has been updated.

      Hide data attributes Show data attributes object
      • cancelledAt string(date-time) | null Required

        The timestamp when the cart was cancelled.

      • clientId string(uuid) Required

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

      • completedAt string(date-time) | null Required

        The timestamp when the cart checkout was completed.

      • createdAt string(date-time) Required

        The timestamp when the cart was created.

      • expiresAt string(date-time) | null Required

        The timestamp when the cart will expire.

      • 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 Point of interest associated with this cart.

      • status string Required

        The current status of the cart.

        Values are PENDING, CANCELLED, CHECKOUT_PROCESSING, CHECKOUT_FAILED, CHECKOUT_COMPLETED, or CHECKOUT_CANCELLED.

      • 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.
  • 401

    Client authentication failed.

  • 403

    Missing one or more required scopes.

  • 404

    The specified cart was not found.

  • 500

    An unexpected error occurred.

POST /2025-3/carts/{cartId}/payment-method 
curl \
 --request POST 'https://api.pace.cloud/cart/2025-3/carts/9239a6a6-de5b-4ccc-ba58-40ede174a5a0/payment-method' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "paymentMethodId": "f90731f2-3628-4194-a628-6a36b7058405"
}'
Request examples 
{
  "paymentMethodId": "f90731f2-3628-4194-a628-6a36b7058405"
}
Response examples (200) 
{
  "data": {
    "cancelledAt": "2023-05-15T14:30:00.000Z",
    "clientId": "0feb6be6-7314-469b-83ac-5b9b7e4b4a4e",
    "completedAt": "2023-05-15T15:00:00.000Z",
    "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": "PENDING",
    "updatedAt": "2023-05-15T14:15:00.000Z",
    "userId": "e9166a60-1f92-4a5d-a192-c2f6b662e9d9"
  }
}