What is CardTypeId and TokenTypeId in card order request?

Card Type refers to the classification of a Shell card based on its intended usage, access scope, and geographical applicability.

It determines the card’s operational parameters. CardTypeId is a numeric identifier of the CardType.

TokenType is an optional parameter during card order. A token type defines card visuals and what card mailer will be used with newly ordered card.

When CardTypeId and TokenTypeId is provided during the card order, the combination of CardTypeId and TokenTypeId must exist in Shell system.

Usage Category:

Fleet: For fleet vehicles(light commercial vehicles, passenger cars, service vehicles); lower transaction limits, higher transaction frequency.
Commercial Road Transport(heavy duty trucks, long-haul transport vehicles): These card types will be default have higher transaction limits.

Acceptance Scope:
Single : Usable only at Shell stations.
Multi : Usable at Shell and partner locations
Hybrid: - card accepted on Shell Recharge and roaming locations

Geographical Scope:
National: Usable only in the issuing country.
International: Usable across multiple countries.
 

CardType Configuration

When a customer signs a Shell Card agreement, Shell creates a card account for the customer.
As part of account setup, Shell configures the allowed CardTypes based on the agreement. These define what types of cards the customer can order.
 

CardType must be:

• Active and configured at the card account level.

• CardTypeId provided in card order requests, is not setup on the account. Request will be accepted and error will be returned in /card-management/v1/ordercardenquiry call - 

          {
              "AccountId": 12,
              "AccountNumber": "DE00000012",
              "BCOReference": null,
              "BCORowNumber": null,
              "CardGroupId": null,
              "CardGroupName": null,
              "CardId": null,
              "CardPAN": null,
              "CardTypeCode": null,
              "CardTypeId": 206,
              "CardTypeName": null,
              "DriverName": null,
              "ErrorCode": "12011",
              "ErrorDescription": "Order card request validation failed for the input parameter(s) - [Invalid CardTypeId. ]",
              "GatewaySyncErrorCode": null,
              "GatewaySyncErrorDescription": null,
              "GatewaySyncStatus": null,
              "MainReference": 715047,
              "OrderCardReference": 947113,
              "OrderStatus": "X",
              "PayerId": 12,
              "PayerNumber": "DE00000012",
              "ProcessedDate": "20250826 13:12:52",
              "PurchaseCategoryCode": null,
              "PurchaseCategoryId": 124,
              "PurchaseCategoryName": null,
              "SubmittedDate": "20250826 15:11:50",
              "SyncProcessedDate": null,
              "SyncRequestedDate": null,
              "VRN": null,
              "OrderRequestId": "233e4567-1313-12d3-a456-426614174000",
              "ExpiryDate": null,
              "ClientReferenceId": null,
              "StatusDescription": "Failed"
          }

• Mandatory during card ordering. When not provided, API will return  Status code 400 with below validation error

  {
      "RequestId": "233e4567-1313-12d3-a456-426614174000",
      "Status": "FAILED",
      "Errors": [
          {
              "Code": "E0001",
              "Title": "Validation Error",
              "Detail": "Missing / Invalid value(s) for: [CardDetails[0]]",
              "AdditionalInfo": {
                  "CardTypeId": "Invalid | Range (1,2147483647)"
              }
          }
      ]
  }

To get CardTypeIds available on the account, call /customer-management/v1/cardtype endpoint.