「卡片類型」是指根據 Shell 卡片的使用目的、存取範圍及地理適用範圍所進行的分類。
它決定了該卡片的運作參數。 CardTypeId 是 CardType 的數值識別碼。
TokenType 是訂購卡片時的選填參數。 代幣類型定義了卡片的外觀，以及新訂購的卡片將使用何種卡片郵寄方式。
當在訂購卡片時提供 CardTypeId 和 TokenTypeId 時，CardTypeId 與 TokenTypeId 的組合必須存在於 Shell 系統中。
使用類別：
車隊：適用於車隊車輛（輕型商用車、乘用車、服務用車）；交易限額較低，交易頻率較高。
商用 路 運 輸 運 (重型卡車、長途運輸車輛)： 這些卡片類型預設將具有較高的交易限額。
接受範圍：
單一 ：僅限於殼牌加油站使用。
多用途 ：可在殼牌及合作夥伴據點使用
混合型：- 此卡可在殼牌 Recharge 及漫遊據點使用
地理範圍：
全國：僅限於發卡國使用。
國際：可在多個國家使用。
卡片類型設定
當客戶簽署殼牌卡協議時，殼牌會為該客戶建立一個卡片帳戶。
作為帳戶設定的一部分，殼牌會根據協議設定允許的卡片類型。 這些設定定義了客戶可以訂購的卡片類型。
卡片類型必須：
- 處於有效狀態，並已在卡片帳戶層級完成設定。
-
卡片訂購請求中提供的 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, "訂單卡片參考編號": 947113, "訂單狀態": "X", "付款人 ID": 12, "付款人號碼": "DE00000012", "處理日期": "20250826 13:12:52", "購買類別代碼": null, "購買類別 ID": 124, "購買類別名稱": null, "提交日期": "20250826 15:11:50", "同步處理日期": null, "同步請求日期": null, "VRN": null, "訂單請求編號": "233e4567-1313-12d3-a456-426614174000", "ExpiryDate": null, "ClientReferenceId": null, "StatusDescription": "失敗" } -
訂購卡片時為必填欄位。 若未提供，API 將回傳狀態碼 400 並附帶以下驗證錯誤
{ "RequestId": "233e4567-1313-12d3-a456-426614174000", "Status": "FAILED", "Errors": [ { "Code": "E0001", "Title": "驗證錯誤", "Detail": "以下欄位值缺失或無效：[CardDetails[0]]", "AdditionalInfo": { "CardTypeId": "無效 | 範圍 (1,2147483647)" } } ] }
若要取得該帳戶可用的 CardTypeId，請呼叫 /customer-management/v1/cardtype 端點。
