Co to jest CardTypeId i TokenTypeId w żądaniu zamówienia karty?

Typ karty odnosi się do klasyfikacji karty Shell w oparciu o jej przeznaczenie, zakres dostępu i zastosowanie geograficzne.

Określa parametry operacyjne karty. CardTypeId jest numerycznym identyfikatorem CardType.

TokenType jest opcjonalnym parametrem podczas zamawiania karty. Typ tokena definiuje wizualizację karty i to, jaki mailer karty zostanie użyty z nowo zamówioną kartą.

Gdy CardTypeId i TokenTypeId są podawane podczas zamawiania karty, kombinacja CardTypeId i TokenTypeId musi istnieć w systemie Shell.

Kategoria użytkowania:

Flota: Dla pojazdów flotowych (lekkie pojazdy użytkowe, samochody osobowe, pojazdy serwisowe); niższe limity transakcji, wyższa częstotliwość transakcji.
Commercial Road Transport (ciężkie samochody ciężarowe, pojazdy do transportu długodystansowego): Te typy kart będą miały domyślnie wyższe limity transakcji.

Zakres akceptacji:
Single : Można używać tylko na stacjach Shell.
Multi : Używana na stacjach Shell i w punktach partnerskich
Hybrid: - karta akceptowana na stacjach Shell Recharge i w roamingu

Zakres geograficzny:
Krajowy: Można używać tylko w kraju, który wydał kartę.
Międzynarodowy: Możliwość korzystania w wielu krajach.

Konfiguracja typów kart

Kiedy klient podpisuje umowę Shell Card, Shell tworzy dla niego konto karty.
W ramach konfiguracji konta Shell konfiguruje dozwolone typy kart w oparciu o umowę. Określają one typy kart, które klient może zamówić.

CardType musi być:

• Aktywny i skonfigurowany na poziomie konta karty.

• CardTypeId podany w żądaniach zamówienia karty, nie jest skonfigurowany na koncie. Żądanie zostanie zaakceptowane i zwrócony zostanie błąd w wywołaniu /card-management/v1/ordercardenquiry -

   {
              "AccountId": 12,
              "AccountNumber": "DE000012",
              "BCOReference": null,
              "BCORowNumber": null,
              "CardGroupId": null,
              "CardGroupName": null,
              "CardId": null,
              "CardPAN": null,
              "CardTypeCode": null,
              "CardTypeId": 206,
              "CardTypeName": null,
              "DriverName": null,
              "ErrorCode": "12011",
              "ErrorDescription": "Walidacja żądania karty zamówienia nie powiodła się dla parametru(ów) wejściowego(ych) - [Invalid CardTypeId. ]",
              "GatewaySyncErrorCode": null,
              "GatewaySyncErrorDescription": null,
              "GatewaySyncStatus": null,
              "MainReference": 715047,
              "OrderCardReference": 947113,
              "OrderStatus": "X",
              "PayerId": 12,
              "PayerNumber": "DE000012",
              "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"
          }

• Obowiązkowe podczas zamawiania karty. Jeśli nie zostanie podany, API zwróci kod statusu 400 z poniższym błędem walidacji

  {
      "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)"
              }
          }
      ]
  }

Aby uzyskać CardTypeIds dostępne na koncie, wywołaj /customer-management/v1/cardtype endpoint.