Il “Tipo di carta” si riferisce alla classificazione di una carta Shell in base all’uso previsto, all’ambito di accesso e all’applicabilità geografica.
Esso determina i parametri operativi della carta. CardTypeId è un identificatore numerico del CardType.
TokenType è un parametro opzionale durante l’ordine della carta. Un tipo di token definisce l’aspetto della carta e quale modello di invio postale verrà utilizzato per la carta appena ordinata.
Quando CardTypeId e TokenTypeId vengono forniti al momento dell’ordine della carta, la combinazione di CardTypeId e TokenTypeId deve esistere nel sistema Shell.
Categoria di utilizzo:
Flotta: Per veicoli della flotta (veicoli commerciali leggeri, autovetture, veicoli di servizio); limiti di transazione inferiori, frequenza di transazione più elevata.
Commercial Road Transport(autocarri pesanti, veicoli per il trasporto a lungo raggio): Questi tipi di carta avranno, per impostazione predefinita, limiti di transazione più elevati.
Ambito di accettazione:
Singolo : Utilizzabile solo presso le stazioni Shell.
Multi : Utilizzabile presso le stazioni Shell e i punti di vendita dei partner
Ibrida: - carta accettata presso i punti di ricarica Shell e in roaming
Ambito geografico:
Nazionale: Utilizzabile solo nel paese di emissione.
Internazionale: utilizzabile in più paesi.
Configurazione del tipo di carta
Quando un cliente sottoscrive un contratto per la Shell Card, Shell crea un conto carta per il cliente.
Come parte della configurazione del conto, Shell imposta i tipi di carta consentiti in base al contratto. Questi definiscono quali tipi di carte il cliente può ordinare.
Il CardType deve essere:
- Attivo e configurato a livello di conto della carta.
-
Il CardTypeId fornito nelle richieste di ordine della carta non è configurato sul conto. La richiesta verrà accettata e verrà restituito un errore nella chiamata /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": "Convalida della richiesta della carta dell’ordine non riuscita per i parametri di input - [CardTypeId non valido.]", "GatewaySyncErrorCode": null, "GatewaySyncErrorDescription": null, "GatewaySyncStatus": null, "MainReference": 715047, "RiferimentoCartaOrdine": 947113, "StatoOrdine": "X", "IDPagatore": 12, "NumeroPagatore": "DE00000012", "ProcessedDate": "20250826 13:12:52", "PurchaseCategoryCode": null, "PurchaseCategoryId": 124, "NomeCategoriaAcquisto": null, "DataInvio": "26/08/2025 15:11:50", "DataElaborazioneSincronizzazione": null, "DataRichiestaSincronizzazione": null, "VRN": null, "ID richiesta d'ordine": "233e4567-1313-12d3-a456-426614174000", "ExpiryDate": null, "ClientReferenceId": null, "StatusDescription": "Failed" } -
Obbligatorio durante l’ordine della carta. Se non fornito, l’API restituirà il codice di stato 400 con il seguente errore di convalida
{ "RequestId": "233e4567-1313-12d3-a456-426614174000", "Status": "FAILED", "Errors": [ { "Code": "E0001", "Title": "Errore di convalida", "Detail": "Valori mancanti o non validi per: [CardDetails[0]]", "Informazioni aggiuntive": { "CardTypeId": "Non valido | Intervallo (1,2147483647)" } } ] }
Per ottenere gli ID dei tipi di carta disponibili sull’account, chiama l’endpoint /customer-management/v1/cardtype.
