Get all payment methods for a specific 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

{
  "Cart MCP server": {
    "url": "https://developer.pace.cloud/doc/cart/mcp"
  }
}

GET /2026-3/carts/{cartId}/payment-methods

Oauth2 Oauth2

Retrieves all available payment methods for the specified cart, including details about each cart item.

Path parameters

cartId string(uuid) Required

The unique identifier of the cart to retrieve the available payment methods for.

Responses

200 application/json

Successfully retrieved payment methods for the cart.
Hide response attribute Show response attribute object
- data array[object] Required
  
  The user payment methods based on a cart, including details for each cart item.
  
  Hide data attributes Show data attributes object
  
  createdAt string(date-time) Required
  
  The date and time when the user payment method was created.
  
  expectedActions object Required
  The actions a checkout with this payment method is expected to request, or an empty list when none are expected. A hint that lets the client collect the values before the checkout, matched by name to the checkout's actions, which stay authoritative.
  
  One of:
  INPUT object MULTI_SELECT object ONE_OF object SINGLE_SELECT object
  
  Hide attributes Show attributes
  
  name string Required
  
  The name of the action, matching the name of the action the checkout requests.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  type string Required Discriminator
  
  The discriminator type of the action.
  
  Value is INPUT.
  
  Hide attributes Show attributes
  
  name string Required
  
  The name of the action, matching the name of the action the checkout requests.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  type string Required Discriminator
  
  The discriminator type of the action.
  
  Value is MULTI_SELECT.
  
  Hide attributes Show attributes
  
  name string Required
  
  The name of the action, matching the name of the action the checkout requests.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  options object Required
  The alternatives the user can choose between.
  
  One of:
  INPUT object MULTI_SELECT object SINGLE_SELECT object
  
  Hide attributes Show attributes
  
  name string Required
  
  The name of the action, matching the name of the action the checkout requests.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  type string Required Discriminator
  
  The discriminator type of the action.
  
  Value is INPUT.
  
  Hide attributes Show attributes
  
  name string Required
  
  The name of the action, matching the name of the action the checkout requests.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  type string Required Discriminator
  
  The discriminator type of the action.
  
  Value is MULTI_SELECT.
  
  Hide attributes Show attributes
  
  name string Required
  
  The name of the action, matching the name of the action the checkout requests.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  type string Required Discriminator
  
  The discriminator type of the action.
  
  Value is SINGLE_SELECT.
  
  type string Required Discriminator
  
  The discriminator type of the action.
  
  Value is ONE_OF.
  
  Hide attributes Show attributes
  
  name string Required
  
  The name of the action, matching the name of the action the checkout requests.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  type string Required Discriminator
  
  The discriminator type of the action.
  
  Value is SINGLE_SELECT.
  
  expiresAt string(date-time) | null Required
  
  The date and time when the user payment method will expire.
  
  icons object Required
  
  The icons associated with the user payment method.
  
  Hide icons attributes Show icons attributes object
  
  dark string(uri) | null Required
  
  The URL to the dark theme icon for the payment method.
  
  default string(uri) Required
  
  The URL to the default icon for the payment method.
  
  id string(uuid) Required
  
  The unique identifier of the user payment method.
  
  implicit boolean Required
  
  Determines whether the user payment method has been onboarded.
  
  items array[object] Required
  
  The payment method item info for each cart item.
  
  Hide items attributes Show items attributes object
  
  contract object Required
  
  The contract this cart item would be purchased under with the payment method, or null when no contract enables the payment method's kind for this cart item.
  
  Hide contract attributes Show contract attributes object
  
  buyer object Required
  
  The party buying under the contract.
  
  Hide buyer attributes Show buyer attributes object
  
  id string(uuid) Required
  
  The unique identifier of the partner.
  
  name string Required
  
  The display name of the partner.
  
  id string(uuid) Required
  
  The unique identifier of the contract.
  
  supplier object Required
  
  The party supplying under the contract.
  
  Hide supplier attributes Show supplier attributes object
  
  id string(uuid) Required
  
  The unique identifier of the partner.
  
  name string Required
  
  The display name of the partner.
  
  id string(uuid) Required
  
  The unique identifier of the cart item.
  
  purchaseable boolean Required
  
  Determines if the payment method can be used to purchase this cart item.
  
  reasonCode string | null Required
  
  The reason why the payment method cannot purchase this cart item, or null when it is purchaseable.
  
  kind string Required
  
  The payment method kind of the user payment method.
  
  label string Required
  
  The localized label of the payment method kind.
  
  lastUsedAt string(date-time) | null Required
  
  The date and time when the user payment method was last used.
  
  metadata object | null Required
  
  Optional metadata associated with the user payment method.
  
  Additional properties are allowed.
  
  name string Required
  
  The name of the user payment method.
  
  onboardingId string(uuid) | null Required
  
  The unique identifier of the onboarding through which the user payment method was created or null if the payment method was not created through an onboarding process.
  
  reasonCode string | null Required
  
  The reason why the payment method cannot check out the cart as a whole, or null when it is usable.
  
  restrictions object Required
  
  The constraints that limit how the payment method may be used, or null when the method has no restrictions.
  
  Hide restrictions attributes Show restrictions attributes object
  
  allowedFuelTypes array[string] | null Required
  
  The fuel types the payment method is allowed to purchase, or null when unrestricted.
  
  allowedProducts array[string] | null Required
  
  The product categories the payment method is allowed to purchase, or null when unrestricted.
  
  maxProducts integer | null Required
  
  The maximum number of products that may be in a cart for a single authorization, or null when unrestricted.
  
  Minimum value is 1.
  
  maximumAuthorizeAmount string(decimal) | null Required
  
  The maximum amount the payment method is allowed to authorize, or null when unrestricted.
  
  Minimum value is 0.
  
  shareCount integer Required
  
  The number of times this user payment method is currently shared with other users.
  
  Minimum value is 0.
  
  shared boolean Required
  
  Determines whether the user payment method is shared by another user.
  
  updatedAt string(date-time) Required
  
  The date and time when the user payment method was last updated.
  
  usable boolean Required
  
  Determines whether the user payment method can be used to checkout the cart.
  
  userId string(uuid) Required
  
  The unique identifier of the user who owns the user payment method.
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.
500

An unexpected error occurred.

GET /2026-3/carts/{cartId}/payment-methods

curl \
 --request GET 'https://api.pace.cloud/cart/2026-3/carts/3682ea8c-4ca4-45d2-bc1e-e6e4dc597ffb/payment-methods' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": [
    {
      "createdAt": "2023-10-01T12:00:00.000Z",
      "expectedActions": {
        "name": "CAR_MILEAGE",
        "optional": false,
        "type": "INPUT"
      },
      "expiresAt": "2025-12-31T23:59:59.999Z",
      "icons": {
        "dark": "https://example.com/icons/dark.png",
        "default": "https://example.com/icons/light.png"
      },
      "id": "86192f0f-9359-415d-b465-3cfadf0130a3",
      "implicit": true,
      "items": [
        {
          "contract": {
            "buyer": {
              "id": "80822967-c556-4b8f-bf72-20ac8c5918d2",
              "name": "Acme Fuels GmbH"
            },
            "id": "f844b31d-64cf-4870-912b-9d0dc15da623",
            "supplier": {
              "id": "80822967-c556-4b8f-bf72-20ac8c5918d2",
              "name": "Acme Fuels GmbH"
            }
          },
          "id": "0c81b3e0-0495-45ce-8df7-6f764c0ef3c5",
          "purchaseable": true,
          "reasonCode": "PRODUCT_NOT_ALLOWED"
        }
      ],
      "kind": "FUEL_CARD_PROVIDER",
      "label": "Fuel Card Provider",
      "lastUsedAt": "2023-10-01T12:00:00.000Z",
      "metadata": {},
      "name": "(MASTERCARD) ... 0640",
      "onboardingId": "a0a99fe0-11b0-47d1-9b07-e7e83e6b0b1d",
      "reasonCode": "AMOUNT_LIMIT_EXCEEDED",
      "restrictions": {
        "allowedFuelTypes": [
          "DIESEL",
          "RON95_E10"
        ],
        "allowedProducts": [
          "FUELING",
          "WASHING"
        ],
        "maxProducts": 3,
        "maximumAuthorizeAmount": "150.00"
      },
      "shareCount": 12,
      "shared": false,
      "updatedAt": "2023-10-01T12:00:00.000Z",
      "usable": true,
      "userId": "76a65fa5-c6ea-4b71-82d9-9689a00b4b8b"
    }
  ]
}