什么是卡订单请求中的 CardTypeId 和 TokenTypeId？

卡片类型是指贝壳卡根据其预期用途、访问范围和地理适用性进行的分类。

它决定了卡片的操作参数。CardTypeId 是 CardType 的数字标识符。

TokenType 是订购卡片时的可选参数。令牌类型定义了卡片的视觉效果，以及新订购的卡片将使用何种卡片邮寄器。

当在订购卡片时提供 CardTypeId 和 TokenTypeId 时，CardTypeId 和 TokenTypeId 的组合必须存在于 Shell 系统中。

使用类别：

车队：
C商用R公路T运输（重型卡车、长途运输车辆）：

受理范围：
单卡：
Multi ：
混合： - 可在壳牌充值和漫游地点使用

地域范围：
全国：
国际卡：可在多个国家使用：
卡类型配置

当客户签署 Shell 卡协议时，Shell 会为客户创建一个卡帐户。
作为帐户设置的一部分，Shell 会根据协议配置允许的卡类型。

CardType必须是：

• 激活并在卡账户级别配置。

• 卡订单请求中提供的 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"：空、
              "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、
              "提交日期"："20250826 15:11:50",
              "SyncProcessedDate": null、
              "SyncRequestedDate": null、
              "VRN": null、
              "OrderRequestId"："233e4567-1313-12d3-a456-426614174000",
              "ExpiryDate": null、
              "ClientReferenceId": null、
              "StatusDescription"：失败
          }

• 订购银行卡时必须提供。如果未提供，API 将返回状态代码 400，并包含以下验证错误

  {
      "RequestId"："233e4567-1313-12d3-a456-426614174000",
      状态"FAILED"、
      "错误"：[
          {
              "代码"："E0001",
              "标题"："验证错误"、
              "详情"："Missing / Invalid value(s) for：[CardDetails[0]]"、
              "AdditionalInfo"：{
                  "CardTypeId"："Invalid | Range (1,2147483647)" （无效值范围 (1,2147483647)
              }
          }
      ]
  }

要获取账户中可用的 CardTypeIds，请调用 /customer-management/v1/cardtype endpoint.