A kártyatípus a Shell-kártya rendeltetés szerinti felhasználása, hozzáférési köre és földrajzi érvényességi területe alapján történő besorolását jelenti.
Ez határozza meg a kártya működési paramétereit. A CardTypeId a CardType numerikus azonosítója.
A TokenType a kártyarendelés során opcionális paraméter. A token típus határozza meg a kártya megjelenését és azt, hogy milyen kártyaküldőt használnak az újonnan megrendelt kártyához.
Ha a kártyarendelés során megadják a CardTypeId-t és a TokenTypeId-t, akkor a CardTypeId és a TokenTypeId kombinációjának léteznie kell a Shell rendszerében.
Használati kategória:
Flotta: Flottájához tartozó járművekhez (könnyű haszongépjárművek, személygépkocsik, szolgálati járművek); alacsonyabb tranzakciós limitek, magasabb tranzakciós gyakoriság.
Commercial Road Transport(nehéz tehergépjárművek, távolsági szállító járművek): Ezek a kártyatípusok alapértelmezés szerint magasabb tranzakciós limitekkel rendelkeznek.
Elfogadási kör:
Egyedi : Csak a Shell töltőállomásokon használható.
Többfunkciós : Használható a Shell és partnerhelyszíneken
Hibrid: - a kártyát a Shell Recharge és roaming helyszíneken is elfogadják
Földrajzi hatály:
Országos: Csak a kibocsátó országban használható.
Nemzetközi: Több országban is használható.
Kártyatípus-konfiguráció
Amikor egy ügyfél aláírja a Shell Card szerződést, a Shell létrehoz egy kártyaszámlát az ügyfél számára.
A számlabeállítás részeként a Shell a szerződés alapján konfigurálja a megengedett kártyatípusokat. Ezek határozzák meg, hogy az ügyfél milyen típusú kártyákat rendelhet.
A kártyatípusnak:
- aktívnak és a kártyaszámla szintjén konfiguráltnak kell lennie.
-
A kártyarendelési kérelmekben megadott kártyatípus-azonosító (CardTypeId) nincs beállítva a számlán. A kérelem elfogadásra kerül, és hibaüzenet kerül visszaadásra a /card-management/v1/ordercardenquiry hívás során –
{ "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": "A kártyaigénylés érvényesítése sikertelen volt a beviteli paraméter(ek) miatt – [Érvénytelen 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" } -
Kötelező a kártya megrendelése során. Ha nem adják meg, az API 400-as állapotkódot ad vissza az alábbi érvényesítési hibával
{ "RequestId": "233e4567-1313-12d3-a456-426614174000", "Status": "HIBA", "Errors": [ { "Code": "E0001", "Title": "Érvényesítési hiba", "Detail": "Hiányzó / érvénytelen érték(ek) a következőhöz: [CardDetails[0]]", "További információk": { "Kártyatípus-azonosító": "Érvénytelen | Tartomány (1,2147483647)" } } ] }
A fiókban elérhető CardTypeId-k lekéréséhez hívja meg a /customer-management/v1/cardtype végpontot.
