Le type de carte désigne la classification d'une carte Shell en fonction de l'utilisation prévue, de l'étendue de l'accès et de l'applicabilité géographique.
Il détermine les paramètres opérationnels de la carte. CardTypeId est un identifiant numérique du type de carte.
TokenType est un paramètre facultatif lors de la commande d'une carte. Un type de jeton définit les visuels de la carte et l'enveloppe qui sera utilisée avec la carte nouvellement commandée.
Lorsque CardTypeId et TokenTypeId sont fournis lors de la commande de la carte, la combinaison de CardTypeId et TokenTypeId doit exister dans le système Shell.
Catégorie d'utilisation:
Flotte : Pour les véhicules de flotte (véhicules utilitaires légers, voitures particulières, véhicules de service) ; limites de transaction plus basses, fréquence de transaction plus élevée.
Commercial RoadTtransport (camions lourds, véhicules de transport longue distance) : Ces types de cartes auront par défaut des limites de transaction plus élevées.
Etendue de l'acceptation:
Single : Utilisable uniquement dans les stations Shell.
Multi : Utilisable dans les stations Shell et partenaires
Hybrid : - carte acceptée dans les stations Shell Recharge et les stations d'itinérance
Etendue géographique:
Nationale : Utilisable uniquement dans le pays émetteur.
International : Utilisable dans plusieurs pays.
Configuration du type de carte
Lorsqu'un client signe un contrat de carte Shell, Shell crée un compte de carte pour le client.
Dans le cadre de la configuration du compte, Shell configure les Types de carte autorisés en fonction du contrat. Ceux-ci définissent les types de cartes que le client peut commander.
CardType doit être :
- Actif et configuré au niveau du compte de carte.
-
CardTypeId fourni dans les demandes de commande de carte, n'est pas configuré sur le compte. La demande sera acceptée et une erreur sera renvoyée dans l'appel 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" : "La validation de la demande de carte de commande a échoué pour le(s) paramètre(s) d'entrée - [Invalid 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" } -
Obligatoire lors de la commande d'une carte. Si elle n'est pas fournie, l'API renverra le code d'état 400 avec l'erreur de validation ci-dessous
{ "RequestId" : "233e4567-1313-12d3-a456-426614174000", "Status" : "FAILED", "Erreurs" : [ { "Code" : "E0001", "Title" : "Erreur de validation", "Détail" : "Valeur(s) manquante(s) / invalide(s) pour : [CardDetails[0]]", "AdditionalInfo" : { "CardTypeId" : "Invalid | Range (1,2147483647)" } } ] }
Pour obtenir les CardTypeIds disponibles sur le compte, appelez /customer-management/v1/cardtype endpoint.
