Skip to main content

Apakah CardTypeId dan TokenTypeId dalam permintaan pesanan kad?

Jenis Kad merujuk kepada pengelasan kad Shell berdasarkan penggunaan yang dimaksudkan, skop capaian, dan kesesuaian geografi. Ia menentukan parameter operasi kad. CardTypeId ialah pengecam numerik bagi CardType.TokenType ialah parameter pilihan semasa pesanan kad. Jenis token menentukan visual kad dan penyedia perkhidmatan pos kad yang akan digunakan untuk kad yang baru dipesan.Apabila CardTypeId dan TokenTypeId disediakan semasa pesanan kad, gabungan CardTypeId dan TokenTypeId mesti wujud dalam sistem Shell.Kategori Penggunaan:Konsep Armada]: Untuk kenderaan armada (kenderaan komersial ringan, kereta penumpang, kenderaan perkhidmatan); had transaksi yang lebih rendah, kekerapan transaksi yang lebih tinggi.Perdagangan Pengangkutan Jalan Raya(treler berat, kenderaan pengangkutan jarak jauh): Jenis kad ini secara lalai mempunyai had transaksi yang lebih tinggi.Skop Penerimaan: Tunggal : Hanya boleh digunakan di stesen Shell.Multi : Boleh digunakan di lokasi Shell dan rakan kongsi. Hibrid: - kad diterima di Shell Recharge dan lokasi merayau.Skop Geografi: Nasional: Boleh digunakan hanya di negara penerbit.Antarabangsa: Boleh digunakan di pelbagai negara. Konfigurasi Jenis KadApabila pelanggan menandatangani perjanjian Kad Shell, Shell akan mencipta akaun kad untuk pelanggan tersebut. Sebagai sebahagian daripada penyediaan akaun, Shell akan mengkonfigurasi Jenis Kad yang dibenarkan berdasarkan perjanjian tersebut. Ini menentukan jenis kad yang boleh dipesan oleh pelanggan. Jenis Kad mesti:Aktif dan dikonfigurasikan pada peringkat akaun kad.ID Jenis Kad yang disediakan dalam permintaan pesanan kad tidak diatur pada akaun. Permintaan akan diterima dan ralat akan dikembalikan dalam panggilan /card-management/v1/ordercardenquiry -

 {
 "AccountId": 12,
            "NomborAkaun": "DE00000012",
 "RujukanBCO": null,
 "NomborBarisBCO": null,
 "IdKumpulanKad": null,
 "NamaKumpulanKad": null,
            "CardId": null,
 "CardPAN": null,
 "CardTypeCode": null,
 "CardTypeId": 206,
 "CardTypeName": null,
            "DriverName": null,
 "ErrorCode": "12011",
 "ErrorDescription": "Pengesahan permintaan kad pesanan gagal untuk parameter input - [ID Jenis Kad Tidak Sah.]",
            "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": "Gagal"
 } Apabila tidak disediakan, API akan mengembalikan kod Status 400 dengan ralat pengesahan di bawah
    "RequestId": "233e4567-1313-12d3-a456-426614174000",
    "Status": "GAGAL",
    "Kesilapan": [
 {
            "Code": "E0001",
 "Title": "Ralat Pengesahan",
 "Detail": "Nilai hilang / tidak sah untuk: [CardDetails[0]]",
            "AdditionalInfo": {
 "CardTypeId": "Tidak sah | Julat (1,2147483647)"
 }
 }
    ]
}Untuk mendapatkan CardTypeIds yang tersedia pada akaun, panggil hujung /customer-management/v1/cardtype.

Tentang kami

Portal Pembangun Shell menyokong rakan kongsi dalam proses pendaftaran ke API Shell dan mengubah idea menjadi penyelesaian yang sedia untuk pengeluaran. Logo Shell

Hubungi

Hubungi kami

Log masuk ke akaun anda

Tanya Penolong AI tentang Shell API dan Produk API