Get a single payment transaction

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/payment/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Payment MCP server": {
    "url": "https://developer.pace.cloud/doc/payment/mcp"
  }
}
Close
GET /2026-2/payment-transactions/{paymentTransactionId}
Oauth2 Oauth2 Oauth2

Retrieve a single payment transaction by its identifier.

Path parameters

  • paymentTransactionId string(uuid) Required

    The unique identifier of the payment transaction to retrieve.

Responses

  • 200 application/json

    The payment transaction was retrieved successfully.

    Hide response attribute Show response attribute object
    • data object Required

      The payment transaction for the given payment transaction ID.

      Hide data attributes Show data attributes object
      • authorizationType string Required

        The type of the authorization for the transaction. Either PENDING if the authorized amount is a temporary hold on the user's funds, or FINAL if the authorized amount is the final amount that will be charged to the user.

        Values are PARTIAL or FINAL.

      • authorizedAmount string(decimal) | null Required

        The amount that was authorized from the payment transaction. This is the amount that was requested to be charged to the user.

        Minimum value is 0.

      • authorizedAt string(date-time) | null Required

        The date and time when the payment transaction was authorized

      • cancelledAt string(date-time) | null Required

        The timestamp when the transaction was cancelled. This field is only set if the transaction was cancelled.

      • capturedAmount string(decimal) | null Required

        The amount that was captured from the payment transaction. This is the amount that was actually charged to the user.

        Minimum value is 0.

      • capturedAt string(date-time) | null Required

        The date and time when the payment transaction was captured

      • cartId string(uuid) Required

        The unique identifier of the cart associated with the payment transaction.

      • clientId string Required

        The identifier of the client that authorized the payment transaction.

      • createdAt string(date-time) Required

        The date and time when the payment transaction was created

      • currency string Required

        The currency of the transaction.

      • failedAt string(date-time) | null Required

        The timestamp when the transaction failed. This field is only set if the transaction failed.

      • failureCode string | null Required

        The failure code of the transaction. This field is only set if the transaction failed.

        Values are PAYMENT_METHOD_EXPIRED, INVALID_CARD_NUMBER, INSUFFICIENT_FUNDS, FRAUD_DETECTED, RESTRICTED_CARD, WITHDRAWAL_LIMIT_EXCEEDED, WITHDRAWAL_FREQUENCY_LIMIT_EXCEEDED, DECLINED_BY_ISSUER, TERMINAL_NOT_AVAILABLE, PROVIDER_ERROR, INVALID_METADATA, PROVIDER_NOT_AVAILABLE, PROVIDER_NOT_ENABLED, or UNKNOWN.

      • id string(uuid) Required

        The unique identifier of the payment transaction

      • kind string Required

        The kind of the payment method used for this transaction.

      • paymentMethodId string(uuid) Required

        The unique identifier of the payment method used for the transaction

      • poi object Required

        The point of interaction (POI) where the transaction took place.

        Hide poi attributes Show poi attributes object
        • address object Required

          The address of the point of interest (POI) associated with the payment transaction.

          Hide address attributes Show address attributes object
          • city string Required

            The city of the POI address.

          • country string Required

            The country of the POI address.

          • houseNumber string | null Required

            The house number of the POI address.

          • postalCode string Required

            The postal code of the POI address.

          • street string Required

            The street name of the POI address.

        • id string(uuid) Required

          The unique identifier of the point of interest (POI) associated with the payment transaction.

        • name string Required

          The name of the point of interest (POI).

        • timeZone string(time-zone) Required

          The IANA time zone of the point of interest (POI).

      • products object Required

        A list of products that are part of the transaction. Useful for reporting purposes like receipts.

        One of:
        CANCELLED object CONFIGURED object CONFIGURING object
      • proxy boolean Required

        Determines whether the payment transaction is a proxy transaction.

      • status string Required

        The current status of the payment transaction.

        Values are AUTHORIZING, AUTHORIZING_ACTIONS_REQUIRED, AUTHORIZING_FAILED, AUTHORIZING_CANCELLED, AUTHORIZED, AUTHORIZED_CANCELLING, AUTHORIZED_CANCELLING_FAILED, AUTHORIZED_CANCELLED, CAPTURING, CAPTURING_FAILED, CAPTURING_CANCELLED, or CAPTURED.

      • summary object Required

        The summary of the transaction, including the total amounts from each product.

        Hide summary attributes Show summary attributes object
        • currency string Required

          The currency of the transaction. This value matches the currency of each product in the transaction.

        • totalAmountExcludingVAT string(decimal) Required

          The total transaction amount excluding VAT.

          Minimum value is 0.

        • totalAmountIncludingVAT string(decimal) Required

          The total transaction amount including VAT.

          Minimum value is 0.

        • vatAmount string(decimal) Required

          The total VAT amount for the transaction.

          Minimum value is 0.

      • updatedAt string(date-time) Required

        The date and time when the payment transaction was last updated

      • userId string(uuid) Required

        The unique identifier of the user associated with the payment transaction.
  • 400

    The request parameters are invalid or missing.

  • 401

    Client authentication failed.

  • 403

    Missing one or more required scopes.

  • 404

    The payment transaction was not found.

  • 500

    An internal server error occurred.

GET /2026-2/payment-transactions/{paymentTransactionId} 
curl \
 --request GET 'https://api.pace.cloud/payment/2026-2/payment-transactions/6fc2acbd-3afd-4df3-9967-836a7929b13f' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "data": {
    "authorizationType": "PARTIAL",
    "authorizedAmount": "120.00",
    "authorizedAt": "2023-10-01T12:00:00.000Z",
    "cancelledAt": "2023-10-01T12:00:00.000Z",
    "capturedAmount": "46.87",
    "capturedAt": "2023-10-01T12:00:00.000Z",
    "cartId": "317643aa-b684-44de-873c-a72d9ed766ee",
    "clientId": "pace-drive-app",
    "createdAt": "2023-10-01T12:00:00.000Z",
    "currency": "EUR",
    "failedAt": "2023-10-01T12:00:00.000Z",
    "failureCode": "INSUFFICIENT_FUNDS",
    "id": "6fc2acbd-3afd-4df3-9967-836a7929b13f",
    "kind": "FUEL_CARD_PROVIDER",
    "paymentMethodId": "b4fd81c9-8969-4323-98b7-855a7d7f0d60",
    "poi": {
      "address": {
        "city": "Karlsruhe",
        "country": "DE",
        "houseNumber": "18",
        "postalCode": "76131",
        "street": "Haid-und-Neu-Straße"
      },
      "id": "154e01ae-557a-48b3-a68a-609f1507db1d",
      "name": "PACE Fuel Station",
      "timeZone": "Europe/Berlin"
    },
    "products": {
      "buyerId": "0151f0e1-f932-4d3a-9e2a-0f3818b8cb1c",
      "configurations": {
        "label": "Pump Number",
        "name": "PUMP_NUMBER",
        "type": "INPUT",
        "value": "100.00"
      },
      "contractId": "3fc6db3b-615c-4db2-9d86-c37e9df8ae47",
      "currency": "EUR",
      "id": "8394e4df-95f6-4b9e-87da-4982c0aaec4b",
      "label": "Fueling",
      "priceExcludingVAT": "61.34",
      "priceIncludingVAT": "72.99",
      "pricePerUnitExcludingVAT": "1.596",
      "pricePerUnitIncludingVAT": "1.899",
      "quantity": "38.62",
      "status": "CANCELLED",
      "supplierId": "1dd3721c-7c7b-4acb-8adc-e027267f603c",
      "type": "FUELING",
      "unit": "LITER",
      "vatAmount": "13.63",
      "vatRate": "0.19"
    },
    "proxy": true,
    "status": "CAPTURED",
    "summary": {
      "currency": "EUR",
      "totalAmountExcludingVAT": "88.90",
      "totalAmountIncludingVAT": "104.84",
      "vatAmount": "15.94"
    },
    "updatedAt": "2023-10-01T12:00:00.000Z",
    "userId": "a1c782d9-7a6c-4e5a-b05b-1d11b93c510a"
  }
}