Какво представляват CardTypeId и TokenTypeId в заявката за поръчка на карта?

Типът на картата се отнася до класификацията на картата Shell въз основа на нейното предназначение, обхват на достъпа и географска приложимост.

Той определя оперативните параметри на картата. CardTypeId е числовият идентификатор на CardType.

TokenType е опционален параметър при поръчката на картата. Типът на токена определя визията на картата и какъв пощенски плик ще се използва за новопоръчаната карта.

Когато CardTypeId и TokenTypeId се предоставят при поръчката на картата, комбинацията от CardTypeId и TokenTypeId трябва да съществува в системата на Shell.

Категория на употреба:

Автопарк: За превозни средства от автопарк (леки търговски превозни средства, леки автомобили, сервизни превозни средства); по-ниски лимити на транзакциите, по-висока честота на транзакциите.
Commercial Road Transport(тежкотоварни камиони, превозни средства за превоз на дълги разстояния): Тези типове карти по подразбиране ще имат по-високи лимити на транзакциите.

Обхват на приемане:
Единичен : Може да се използва само на бензиностанции Shell.
Мулти : Може да се използва в обекти на Shell и партньори
Хибридна: - картата се приема в обектите на Shell Recharge и в роуминг

Географски обхват:
Национален: Може да се използва само в страната на издаване.
Международен: Може да се използва в няколко държави.

Конфигурация на CardType

Когато клиентът подпише договор за Shell Card, Shell създава картово сметка за клиента.
Като част от настройката на сметката Shell конфигурира разрешените CardTypes въз основа на договора. Те определят какви видове карти може да поръча клиентът.

Типът на картата трябва да бъде:

• Активен и конфигуриран на ниво сметка за карта.

• CardTypeId, предоставен в заявките за поръчка на карти, не е настроен в сметката. Заявката ще бъде приета, а грешката ще бъде върната при извикването на /card-management/v1/ordercardenquiry –

   {
   "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": "Валидирането на заявката за поръчка на карта се провали за въведените параметри – [Невалиден 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"
   }

• Задължително при поръчка на карта. Когато не е предоставено, API ще върне статусен код 400 с следната грешка при валидиране

  {
      "RequestId": "233e4567-1313-12d3-a456-426614174000",
      "Status": "FAILED",
      "Errors": [
   {
              "Code": "E0001",
   "Title": "Грешка при валидиране",
   "Detail": "Липсващи/невалидни стойности за: [CardDetails[0]]",
              "Допълнителна информация": {
   "CardTypeId": "Невалиден | Диапазон (1,2147483647)"
   }
   }
      ]
  }

За да получите CardTypeIds, налични в акаунта, извикайте крайната точка /customer-management/v1/cardtype.