GET /2026-2/payment-methods/{paymentMethodId}

Get a specific payment method by ID.

Path parameters

  • paymentMethodId string(uuid) Required

    The unique identifier of the payment method to retrieve.

Query parameters

  • userId string(uuid)

    The unique identifier of the user to retrieve the payment method for.

Responses

  • 200 application/json

    The payment method was successfully retrieved.

    Hide response attribute Show response attribute object
    • data object Required

      The user payment method that was retrieved.

      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.

  • 401

    Client authentication failed.

  • 403

    Missing one or more required scopes.

  • 404

    The payment method was not found.

  • 500

    An internal server error occurred.

GET /2026-2/payment-methods/{paymentMethodId}
curl \
 --request GET 'https://api.pace.cloud/payment/2026-2/payment-methods/e7b23b4b-3957-499f-98e9-7205b581d8ac' \
 --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"
  }
}