Wat zijn CardTypeId en TokenTypeId in kaartbestelverzoek?

Kaarttype verwijst naar de classificatie van een Shell-kaart op basis van het beoogde gebruik, het toegangsbereik en de geografische toepasbaarheid.

Het bepaalt de operationele parameters van de kaart. CardTypeId is een numerieke identificatie van het CardType.

TokenType is een optionele parameter tijdens het bestellen van de kaart. Een tokentype definieert het kaartbeeld en welke kaartmailer wordt gebruikt voor de nieuw bestelde kaart.

Als CardTypeId en TokenTypeId worden opgegeven bij de kaartbestelling, moet de combinatie van CardTypeId en TokenTypeId bestaan in het Shell-systeem.

Gebruikscategorie:

Fleet: Voor wagenparkvoertuigen (lichte bedrijfsvoertuigen, personenauto's, dienstvoertuigen); lagere transactielimieten, hogere transactiefrequentie.
Commercial Road Transport (zware vrachtwagens, langeafstandstransportvoertuigen): Deze kaarttypen hebben standaard hogere transactielimieten.

Acceptatiebereik:
Single : Alleen te gebruiken bij Shell-stations.
Multi : Te gebruiken op Shell- en partnerlocaties
Hybrid: - kaart geaccepteerd op Shell Recharge- en roaminglocaties

Geografisch toepassingsgebied:
Nationaal: Alleen bruikbaar in het land van uitgifte.
Internationaal: Bruikbaar in meerdere landen.

CardType Configuration

Wanneer een klant een Shell Card-overeenkomst ondertekent, maakt Shell een kaartaccount aan voor de klant.
Tijdens het instellen van de account configureert Shell de toegelaten CardTypes op basis van de overeenkomst. Deze definiëren welke typen kaarten de klant kan bestellen.

CardType moet zijn:

• Actief en geconfigureerd op kaartaccountniveau.

• CardTypeId die is opgegeven in kaartorderverzoeken, is niet ingesteld op de account. Het verzoek wordt geaccepteerd en er wordt een fout geretourneerd in de /card-management/v1/ordercardenquiry-oproep -

   {
              "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": "Validatie bestelkaartverzoek mislukt voor de invoerparameter(s) - [Ongeldige 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,
              "Ingediendatum": "20250826 15:11:50",
              "SyncProcessedDate": null,
              "SyncRequestedDate": null,
              "VRN": null,
              "OrderRequestId": "233e4567-1313-12d3-a456-426614174000",
              "ExpiryDate": null,
              "ClientReferenceId": null,
              "StatusDescription": "Failed".
          }

• Verplicht tijdens het bestellen van kaarten. Als deze niet wordt opgegeven, retourneert de API statuscode 400 met de onderstaande validatiefout

  {
      "RequestId": "233e4567-1313-12d3-a456-426614174000",
      "Status: "FAILED",
      "Fouten": [
          {
              "Code": "E0001",
              "Titel": "Validatiefout",
              "Detail": "Ontbrekende/ongeldige waarde(n) voor: [CardDetails[0]]",
              "AdditionalInfo": {
                  "CardTypeId": "Ongeldig | Range (1,2147483647)".
              }
          }
      ]
  }

Om CardTypeIds op te vragen die beschikbaar zijn op de account, belt u /customer-management/v1/cardtype endpoint.