Typ karty označuje klasifikáciu karty Shell na základe jej zamýšľaného použitia, rozsahu prístupu a geografickej platnosti.
Určuje prevádzkové parametre karty. CardTypeId je číselný identifikátor typu karty (CardType).
TokenType je voliteľný parameter pri objednávaní karty. Typ tokenu definuje vizuálnu podobu karty a typ obálky, ktorá sa použije pri zasielaní novo objednaných kariet.
Ak sa pri objednávke karty zadajú hodnoty CardTypeId a TokenTypeId, táto kombinácia musí existovať v systéme Shell.
Kategória použitia:
Vozový park: Pre vozidlá vozového parku (ľahké úžitkové vozidlá, osobné automobily, servisné vozidlá); nižšie transakčné limity, vyššia frekvencia transakcií.
Komercial Road Transport(ťažké nákladné vozidlá, vozidlá diaľkovej dopravy): Tieto typy kariet budú mať štandardne vyššie transakčné limity.
Rozsah akceptácie:
Single : Použiteľné iba na čerpacích staniciach Shell.
Multi : Použiteľná na čerpacích staniciach Shell a u partnerov
Hybrid: – karta akceptovaná na čerpacích staniciach Shell Recharge a v rámci roamingu
Geografický rozsah:
Národný: Použiteľná iba v krajine vydania.
Medzinárodný: Použiteľný vo viacerých krajinách.
Konfigurácia typu karty
Keď zákazník podpíše zmluvu o karte Shell, spoločnosť Shell mu vytvorí kartový účet.
V rámci nastavenia účtu spoločnosť Shell nakonfiguruje povolené typy kariet na základe zmluvy. Tie určujú, aké typy kariet si zákazník môže objednať.
Typ karty musí byť:
- Aktívny a nakonfigurovaný na úrovni kartového účtu.
-
ID typu karty uvedené v žiadostiach o objednávku karty nie je na účte nastavené. Žiadosť bude prijatá a v rámci volania /card-management/v1/ordercardenquiry sa vráti chyba –
{ "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": "Overenie žiadosti o kartu zlyhalo pre zadané vstupné parametre – [Neplatný CardTypeId.]", "Kód chyby synchronizácie brány": null, "Popis chyby synchronizácie brány": null, "Stav synchronizácie brány": null, "Hlavný referenčný kód": 715047, "OrderCardReference": 947113, "OrderStatus": "X", "PayerId": 12, "PayerNumber": "DE00000012", "ProcessedDate": "20250826 13:12:52", "PurchaseCategoryCode": null, "PurchaseCategoryId": 124, "Názov kategórie nákupu": null, "Dátum odoslania": "20250826 15:11:50", "Dátum spracovania synchronizácie": null, "Dátum požiadavky na synchronizáciu": null, "VRN": null, "OrderRequestId": "233e4567-1313-12d3-a456-426614174000", "ExpiryDate": null, "ClientReferenceId": null, "StatusDescription": "Failed" } -
Povinné pri objednávaní karty. Ak nie je uvedené, API vráti stavový kód 400 s nasledujúcou chybou overenia
{ "RequestId": "233e4567-1313-12d3-a456-426614174000", "Status": "FAILED", "Errors": [ { "Code": "E0001", "Title": "Chyba overenia", "Detail": "Chýbajúce / neplatné hodnoty pre: [CardDetails[0]]", "AdditionalInfo": { "CardTypeId": "Neplatné | Rozsah (1,2147483647)" } } ] }
Ak chcete získať identifikátory typov kariet (CardTypeIds) dostupné na účte, volajte koncový bod /customer-management/v1/cardtype.
