Was bedeuten CardTypeId und TokenTypeId in der Kartenbestellanfrage?

Kartentyp bezieht sich auf die Klassifizierung einer Shell-Karte auf der Grundlage ihrer beabsichtigten Verwendung, ihres Zugangsbereichs und ihrer geografischen Anwendbarkeit.

Er bestimmt die Betriebsparameter der Karte. CardTypeId ist ein numerischer Bezeichner des CardType.

TokenType ist ein optionaler Parameter bei der Kartenbestellung. Ein Token-Typ definiert das Kartenbild und den Kartenversender, der für die neu bestellte Karte verwendet wird.

Wenn CardTypeId und TokenTypeId bei der Kartenbestellung angegeben werden, muss die Kombination aus CardTypeId und TokenTypeId im Shell-System vorhanden sein.

Verwendungskategorie:

Flotte: Für Flottenfahrzeuge (leichte Nutzfahrzeuge, Personenkraftwagen, Servicefahrzeuge); niedrigere Transaktionslimits, höhere Transaktionshäufigkeit.
CGewerblichRStraßeTTransport (Schwerlastkraftwagen, Langstreckentransportfahrzeuge): Diese Kartentypen haben standardmäßig höhere Transaktionslimits.

Akzeptanzumfang:
Single: Nur an Shell Stationen verwendbar.
Multi : Verwendbar an Shell und Partnerstationen
Hybrid: - Karte wird an Shell Recharge- und Roaming-Stationen akzeptiert

Geografischer Geltungsbereich:
National: Nur im ausstellenden Land verwendbar.
International: Nutzbar in mehreren Ländern.

Kartentyp-Konfiguration

Wenn ein Kunde einen Shell Card Vertrag abschließt, erstellt Shell ein Kartenkonto für den Kunden.
Als Teil der Kontoeinrichtung konfiguriert Shell die erlaubten Kartentypen auf der Grundlage des Vertrags. Diese legen fest, welche Arten von Karten der Kunde bestellen kann.

CardType muss:

• Aktiv und auf der Ebene des Kartenkontos konfiguriert sein.

• CardTypeId, die in Kartenbestellungsanfragen angegeben wird, ist nicht auf dem Konto eingerichtet. Die Anfrage wird akzeptiert und ein Fehler wird im /card-management/v1/ordercardenquiry-Aufruf zurückgegeben -

   {
              "AccountId": 12,
              "AccountNumber": "DE00000012",
              "BCOReference": null,
              "BCORowNumber": null,
              "CardGroupId": null,
              "KartenGruppenName": null,
              "KartenId": null,
              "KartenPAN": null,
              "CardTypeCode": null,
              "CardTypeId": 206,
              "KartenTypName": null,
              "FahrerName": null,
              "ErrorCode": "12011",
              "ErrorDescription": "Validierung der Kartenanforderung für den/die Eingabeparameter fehlgeschlagen - [Ungültige CardTypeId. ]",
              "GatewaySyncErrorCode": null,
              "GatewaySyncFehlerBeschreibung": 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"
          }

• Pflichtangabe bei der Kartenbestellung. Wenn nicht angegeben, gibt die API den Statuscode 400 mit folgendem Validierungsfehler zurück

  {
      "RequestId": "233e4567-1313-12d3-a456-426614174000",
      "Status": "FAILED",
      "Errors": [
          {
              "Code": "E0001",
              "Titel": "Überprüfungsfehler",
              "Detail": "Fehlende/ungültige(r) Wert(e) für: [CardDetails[0]]",
              "AdditionalInfo": {
                  "CardTypeId": "Ungültig | Bereich (1,2147483647)"
              }
          }
      ]
  }

Um die für das Konto verfügbaren CardTypeIds abzurufen, rufen Sie /customer-management/v1/cardtype endpoint.