GET /2026-2/payment-methods

Get the payment methods for a specific user or onboarding.

Query parameters

  • filter object | string

Responses

  • 200 application/json

    The payment methods were successfully retrieved.

    Hide response attribute Show response attribute object
    • data array[object] Required

      A list of payment methods for a specific user.

      Hide data attributes Show data attributes object
      • createdAt string(date-time) Required

        The date and time when the payment method was created.

      • expiresAt string(date-time) | null Required

        The date and time when the payment method will expire.

      • icons object Required

        The icons to use for this payment method.

        Hide icons attributes Show icons attributes object
        • dark string(uri) | null Required

          An optional URL of the dark theme icon for the payment method.

        • default string(uri) Required

          The URL of the default icon for the payment method.

      • id string(uuid) Required

        The unique identifier for the payment method.

      • implicit boolean Required

        A boolean indicating whether the payment method is implicit. Implicit payment methods are not onboarded by the user but rather the system during authorization.

      • kind string Required

        The kind of the 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 payment method was last used to capture a payment transaction.

      • metadata object | null Required

        An optional object containing additional metadata for the payment method.

        Additional properties are allowed.

      • name string Required

        A human-readable name for the payment method.

      • onboardingId string(uuid) | null Required

        The unique identifier of the onboarding through which the payment method was created. This is null if the payment method was not created through an onboarding process.

      • proxy boolean Required

        A boolean indicating whether the payment method is a proxy payment method.

      • shareCount integer Required

        The number of shares for the payment method with other users.

        Minimum value is 0.

      • shared boolean Required

        A boolean indicating whether the payment method is shared by other user.

      • updatedAt string(date-time) Required

        The date and time when the payment method was last updated.

      • userId string(uuid) Required

        The unique identifier of the user associated with the payment method.

  • 400

    The request was malformed or missing required parameters.

  • 401

    Client authentication failed.

  • 403

    Missing one or more required scopes.

  • 404

    The onboarding to be filtered by does not exist.

  • 500

    An internal server error occurred.

GET /2026-2/payment-methods
curl \
 --request GET 'https://api.pace.cloud/payment/2026-2/payment-methods' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "data": [
    {
      "createdAt": "2023-10-01T12:00:00.000Z",
      "expiresAt": "2023-10-01T12:00:00.000Z",
      "icons": {
        "dark": "https://example.com/icons/payment-methods/example-dark.svg",
        "default": "https://example.com/icons/payment-methods/example-light.svg"
      },
      "id": "40d8d9b4-ed3a-4a21-9745-5d86279a1dcd",
      "implicit": true,
      "kind": "FUEL_CARD_PROVIDER",
      "label": "Fuel Card Provider",
      "lastUsedAt": "2023-10-01T12:00:00.000Z",
      "metadata": {},
      "name": "XYZ ending in 1234",
      "onboardingId": "28da8789-53c8-4801-814c-db62a40d34df",
      "proxy": false,
      "shareCount": 12,
      "shared": false,
      "updatedAt": "2023-10-01T12:00:00.000Z",
      "userId": "f0fa68e4-674d-4145-a2a2-189816caf7af"
    }
  ]
}